fg-devkit 1.14.5 → 1.15.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fg-devkit",
-  "version": "1.14.5",
+  "version": "1.15.0",
   "description": "Shared configs, scripts, and DX tooling for Vue / TypeScript frontend repos",
   "type": "module",
   "license": "UNLICENSED",

package/scaffold/vue/package.json

@@ -33,7 +33,7 @@
     "@tanstack/vue-query-devtools": "6.1.38",
     "@types/node": "22.16.5",
     "@vitejs/plugin-vue": "6.0.8",
-    "fg-devkit": "1.14.5",
+    "fg-devkit": "1.15.0",
     "tailwindcss": "4.3.3",
     "tsx": "4.23.12",
     "vite": "7.3.5"

package/scripts/fg-devkit.mjs

@@ -559,7 +559,7 @@ Commands:
   fallow [fallow-args...]           Run Fallow using fg-devkit bundled package
   dead-code [fallow-args...]        Run Fallow dead code analysis (shortcut for: fallow dead-code)
   poeditor-download [args...]       Download locale files via PoEditor (reads poeditor/.poeditor.json by default)
-  poeditor-upload [args...]         Upload locale file via PoEditor (reads poeditor/.poeditor.json by default)
+  poeditor-upload [args...]         Upload locale file via PoEditor (reads poeditor/.poeditor.json by default; --sync-terms deletes missing terms)
   scaffold-vue <target-dir> [--name …] [--slug …] [--force] …
                                  Copy the bundled Vue scaffold into target-dir (see script header)
   sync-scaffold-vue-deps [policy-file]
@@ -589,11 +589,14 @@ function isFgDevkitMaintainerContext() {
 
 async function runInteractiveMenu() {
   let selectPrompt
+  let confirmPrompt
   try {
     const inquirerSelect = await import('@inquirer/select')
+    const inquirerConfirm = await import('@inquirer/confirm')
     selectPrompt = inquirerSelect.default
+    confirmPrompt = inquirerConfirm.default
   } catch {
-    console.error('[fg-devkit] Interactive menu requires @inquirer/select but it is not available.')
+    console.error('[fg-devkit] Interactive menu requires @inquirer/select and @inquirer/confirm but they are not available.')
     console.error('[fg-devkit] Run pnpm install in your project and try again.')
     return 1
   }
@@ -769,7 +772,34 @@ async function runInteractiveMenu() {
         loop: false,
       })
       if (choice === 'cancel') continue
-      return runSelectedAction(() => runNode(choice === 'download' ? 'poeditor-download.mjs' : 'poeditor-upload.mjs'))
+      if (choice === 'download') {
+        return runSelectedAction(() => runNode('poeditor-download.mjs'))
+      }
+
+      const uploadMode = await selectPrompt({
+        message: 'Upload mode',
+        choices: [
+          { name: 'Upload (keep terms missing from file)', value: 'upload' },
+          {
+            name: 'Upload + sync terms (delete terms missing from file)',
+            value: 'upload-sync',
+          },
+          { name: 'Cancel', value: 'cancel' },
+        ],
+        default: 'upload',
+        loop: false,
+      })
+      if (uploadMode === 'cancel') continue
+      if (uploadMode === 'upload-sync') {
+        const confirmed = await confirmPrompt({
+          message:
+            'This is a destructive POEditor action: terms not present in the uploaded file will be permanently deleted from the project (including all language translations). Continue?',
+          default: false,
+        })
+        if (!confirmed) continue
+      }
+      const uploadArgs = uploadMode === 'upload-sync' ? ['--sync-terms'] : []
+      return runSelectedAction(() => runNode('poeditor-upload.mjs', uploadArgs))
     }
 
     if (group === 'dependency-policy') {

package/scripts/poeditor-upload.mjs

@@ -4,7 +4,10 @@
  *
  * Usage:
  *   pnpm exec fg-devkit poeditor-upload [--config ./poeditor/.poeditor.json] [--project-id 123]
- *     [--language sv] [--file ./src/lang/sv.json] [--api-token xxx]
+ *     [--language sv] [--file ./src/lang/sv.json] [--api-token xxx] [--sync-terms]
+ *
+ * --sync-terms: Pass sync_terms=1 to PoEditor so terms missing from the uploaded file
+ *               are deleted from the project (destructive; use with care).
  */
 
 import fs from 'node:fs'
@@ -22,6 +25,12 @@ function sleep(ms) {
   })
 }
 
+function isTruthyFlag(value) {
+  if (value === undefined) return false
+  const normalized = String(value).trim().toLowerCase()
+  return normalized === 'true' || normalized === '1' || normalized === 'yes'
+}
+
 function parsePoeditorError(err) {
   const message = err instanceof Error ? err.message : String(err)
   const match = message.match(/Upload failed:\s*(\{.*\})$/)
@@ -46,7 +55,7 @@ function getUploadType(filePath) {
   return extension
 }
 
-async function uploadFile({ token, projectId, language, filePath }) {
+async function uploadFile({ token, projectId, language, filePath, syncTerms = false }) {
   const fileBuffer = fs.readFileSync(filePath)
   const fileName = path.basename(filePath)
   const uploadType = getUploadType(filePath)
@@ -56,6 +65,7 @@ async function uploadFile({ token, projectId, language, filePath }) {
   form.append('updating', 'terms_translations')
   form.append('language', language)
   form.append('overwrite', '1')
+  form.append('sync_terms', syncTerms ? '1' : '0')
   form.append('type', uploadType)
   form.append('file', new Blob([fileBuffer]), fileName)
 
@@ -70,18 +80,20 @@ async function uploadFile({ token, projectId, language, filePath }) {
   if (data?.response?.status !== 'success') {
     throw new Error(`Upload failed: ${JSON.stringify(data)}`)
   }
+  const terms = data?.result?.terms
   const translations = data?.result?.translations
+  const syncNote = syncTerms ? `, terms deleted: ${terms?.deleted ?? 0}` : ''
   console.log(
-    `[poeditor-upload] Upload complete for "${language}" (parsed: ${translations?.parsed ?? 0}, updated: ${translations?.updated ?? 0}, added: ${translations?.added ?? 0})`,
+    `[poeditor-upload] Upload complete for "${language}" (parsed: ${translations?.parsed ?? 0}, updated: ${translations?.updated ?? 0}, added: ${translations?.added ?? 0}${syncNote})`,
   )
 }
 
-async function uploadFileWithRetry({ token, projectId, language, filePath }) {
+async function uploadFileWithRetry({ token, projectId, language, filePath, syncTerms = false }) {
   let attempt = 0
   while (true) {
     attempt += 1
     try {
-      await uploadFile({ token, projectId, language, filePath })
+      await uploadFile({ token, projectId, language, filePath, syncTerms })
       return
     } catch (err) {
       const errorCode = parsePoeditorError(err)
@@ -111,20 +123,32 @@ async function main() {
   }
 
   const projectId = getFlagValue(flags, 'project-id', cfg.projectId)
+  const syncTerms = isTruthyFlag(getFlagValue(flags, 'sync-terms'))
+  if (syncTerms) {
+    console.warn(
+      '[poeditor-upload] --sync-terms enabled: terms not present in the uploaded file will be deleted from PoEditor.',
+    )
+  }
+
   const hasExplicitLanguage = flags.has('language')
   const hasExplicitFile = flags.has('file')
   if (hasExplicitLanguage || hasExplicitFile) {
     const language = getFlagValue(flags, 'language', cfg.defaultLanguage)
     const filePath = resolvePathFromCwd(getFlagValue(flags, 'file', cfg.uploadFile))
-    await uploadFile({ token, projectId, language, filePath })
+    await uploadFile({ token, projectId, language, filePath, syncTerms })
     console.log(`[poeditor-upload] Upload completed for ${language}: ${filePath}`)
     return
   }
 
   const uploads = cfg.uploadFiles && typeof cfg.uploadFiles === 'object' ? Object.entries(cfg.uploadFiles) : []
   if (uploads.length > 0) {
+    if (syncTerms && uploads.length > 1) {
+      console.warn(
+        '[poeditor-upload] --sync-terms with multiple uploadFiles: syncing only on the first file to avoid deleting terms present in other language files.',
+      )
+    }
     let nextUploadAt = 0
-    for (const [language, file] of uploads) {
+    for (const [index, [language, file]] of uploads.entries()) {
       const now = Date.now()
       const waitBeforeUploadMs = Math.max(0, nextUploadAt - now)
       if (waitBeforeUploadMs > 0) {
@@ -133,7 +157,8 @@ async function main() {
       }
 
       const filePath = resolvePathFromCwd(file)
-      await uploadFileWithRetry({ token, projectId, language, filePath })
+      const shouldSyncTerms = syncTerms && index === 0
+      await uploadFileWithRetry({ token, projectId, language, filePath, syncTerms: shouldSyncTerms })
       console.log(`[poeditor-upload] Upload completed for ${language}: ${filePath}`)
       nextUploadAt = Date.now() + MIN_UPLOAD_INTERVAL_MS
     }
@@ -142,7 +167,7 @@ async function main() {
 
   const language = cfg.defaultLanguage
   const filePath = resolvePathFromCwd(cfg.uploadFile)
-  await uploadFileWithRetry({ token, projectId, language, filePath })
+  await uploadFileWithRetry({ token, projectId, language, filePath, syncTerms })
   console.log(`[poeditor-upload] Upload completed for ${language}: ${filePath}`)
 }