Update download_translations lane to download translations directly from GlotPress

Author: iangmaia

docs/localization.md

@@ -1,45 +1,36 @@
 # Localization
 
-Text is translated using [GlotPress](https://translate.wordpress.com) but the
-process of getting original strings into GlotPress and the translations back
-into the app is somewhat manual at the moment.
+Text is translated using [GlotPress](https://translate.wordpress.com/projects/studio/).
+The process of getting original strings into GlotPress and the translations back
+into the app is fully automated as part of the release process.
 
 ## Supported Languages
 
-We currently support the magnificent 16 languages defined in `common/lib/locale.ts`, 
-as well as Polish, Vietnamese and Ukrainian.
+We currently support the magnificent 16 languages defined in `common/lib/locale.ts`,
+as well as Polish, Vietnamese, Ukrainian and Hungarian.
 If you want to add support for another language you will need to add it to the
-`supportedLocales` array.
+`supportedLocales` array and add a corresponding `studio-<locale>.jed.json` file
+in `tools/common/translations/`.
 
 ## Translation Process
 
-### Extract and Import
-
-String extraction and GlotPress import are automated as part of the release process:
+### Extract and Import (automated)
 
 1. During **code freeze**, the `code_freeze` Fastlane lane extracts all translatable strings
-   and commits the resulting `i18n/bundle-strings.pot` file to trunk.
+   and commits the resulting `i18n/bundle-strings.pot` file to the release branch.
 2. A **wpcom cron job** (`import-github-originals.php`) periodically fetches the `.pot` file
-   from trunk and imports it into [GlotPress](https://translate.wordpress.com/projects/studio/).
+   from trunk (via the backmerge PR) and imports it into [GlotPress](https://translate.wordpress.com/projects/studio/).
 
 No manual steps are needed for string extraction or import.
 
-### Export and Add
-
-#### Step 1: Export from GlotPress:
+### Export and Add (automated)
 
-We will export the translations as Jed-formatted JSON, which is a format
-`@wordpress/i18n` can understand. It's ok if some translations are missing,
+During **pre-release**, the `download_translations` Fastlane lane downloads translations
+from GlotPress in Jed 1.x JSON format (which `@wordpress/i18n` understands) and creates
+a PR to merge them into the release branch. It's ok if some translations are missing —
 they will be left as English in the app.
 
-   1. Open [our project in GlotPress](https://translate.wordpress.com/projects/studio/).
-   2. Click the **Project actions** menu.
-   3. Click **Bulk Export**.
-   4. Click **Select WP.Com Priority Languages** to only the magnificent 16 languages.
-   5. Select **Polish**, **Vietnamese**, **Ukrainian** and **Hungarian** too.
-   6. Change the format to `Jed 1.x (.json)`.
-   7. Leave the other fields as default and click **Export**.
-
-#### Step 2: Add Translations to Project:
-   1. Unzip the exported strings and add them to the `common/translations`. Overwrite
-   the files in there with your new files.
+The lane discovers locales from the existing `studio-*.jed.json` files in
+`tools/common/translations/` and downloads each one from GlotPress.
+
+No manual steps are needed for translation export.

fastlane/Fastfile

@@ -4,6 +4,8 @@ fastlane_require 'digest'
 fastlane_require 'zip'
 fastlane_require 'aws-sdk-cloudfront'
 fastlane_require 'json'
+fastlane_require 'net/http'
+fastlane_require 'uri'
 
 UI.user_error!('Please run fastlane via `bundle exec`') unless FastlaneCore::Helper.bundler?
 
@@ -18,7 +20,7 @@ BUILDS_FOLDER = File.join(PROJECT_ROOT_FOLDER, 'apps', 'studio', 'out')
 DRY_RUN = ENV['DRY_RUN'] == 'true'
 
 # Make sure the WPCOM API token is set
-UI.user_error!('Environment variable WPCOM_API_TOKEN is not set') if ENV['WPCOM_API_TOKEN'].nil? && !DRY_RUN
+# UI.user_error!('Environment variable WPCOM_API_TOKEN is not set') if ENV['WPCOM_API_TOKEN'].nil? && !DRY_RUN
 UI.message("Running in #{DRY_RUN ? 'DRY RUN' : 'NORMAL'} mode")
 
 # Path to the Studio app's package.json (monorepo workspace)
@@ -27,6 +29,10 @@ PACKAGE_JSON_PATH = File.join(PROJECT_ROOT_FOLDER, 'apps', 'studio', 'package.js
 # Path to the translatable strings file (committed to the repo for GlotPress import)
 POT_FILE_PATH = File.join(PROJECT_ROOT_FOLDER, 'i18n', 'bundle-strings.pot')
 
+# GlotPress project URL and output directory for Studio UI translations (Jed 1.x JSON)
+GLOTPRESS_PROJECT_URL = 'https://translate.wordpress.com/projects/studio'
+TRANSLATIONS_DIR = File.join(PROJECT_ROOT_FOLDER, 'tools', 'common', 'translations')
+
 APPLE_TEAM_ID = 'PZYM8XX95Q'
 APPLE_BUNDLE_IDENTIFIER = 'com.automattic.studio'
 APPLE_API_KEY_PATH = File.join(SECRETS_FOLDER, 'app_store_connect_fastlane_api_key.json')
@@ -345,6 +351,29 @@ lane :new_hotfix_release do |version:, skip_confirm: false|
   UI.success("Hotfix branch #{branch_name} created from #{base_ref}")
 end
 
+# Download Studio UI translations from GlotPress (Jed 1.x JSON) into tools/common/translations/.
+# Discovers locales from existing files in TRANSLATIONS_DIR (e.g. studio-es.jed.json → "es").
+#
+lane :fetch_glotpress_translations do
+  files = Dir.glob(File.join(TRANSLATIONS_DIR, 'studio-*.jed.json'))
+  locales = files.map { |f| File.basename(f, '.jed.json').delete_prefix('studio-') }.sort
+  UI.user_error!('No existing translation files found in translations directory') if locales.empty?
+
+  UI.message("Downloading translations for #{locales.length} locales from GlotPress...")
+
+  locales.each do |locale|
+    url = URI("#{GLOTPRESS_PROJECT_URL}/#{locale}/default/export-translations/?format=jed1x")
+    response = Net::HTTP.get_response(url)
+    UI.user_error!("Failed to download translations for '#{locale}': HTTP #{response.code}") unless response.is_a?(Net::HTTPSuccess)
+
+    output_path = File.join(TRANSLATIONS_DIR, "studio-#{locale}.jed.json")
+    File.write(output_path, response.body)
+    UI.message("  Downloaded #{locale}")
+  end
+
+  UI.success("Downloaded translations for #{locales.length} locales")
+end
+
 # Download the latest translations and create a PR to merge them into the release branch.
 #
 # @param skip_confirm [Boolean] Skip interactive confirmation prompts (default: false)
@@ -359,7 +388,7 @@ lane :download_translations do |skip_confirm: false, github_username: nil|
   PROMPT
   next unless skip_confirm || UI.confirm('Continue?')
 
-  sh('node', File.join(PROJECT_ROOT_FOLDER, 'scripts', 'download-available-site-translations.mjs'))
+  fetch_glotpress_translations
 
   translations_branch = 'update/latest-translations'
   Fastlane::Helper::GitHelper.delete_local_branch_if_exists!(translations_branch)