feat(cli): add --sound flag for task completion (#1157)

* feat(cli): add --sound flag for task completion

* fix: address review comments

* style: format code with prettier

* chore: formatting

* chore: changeset

---------

Co-authored-by: Veronica Pril <veranika.prilutskaya@gmail.com>

Author: ankur0904

.changeset/seven-papayas-buy.md

@@ -0,0 +1,5 @@
+---
+"lingo.dev": patch
+---
+
+add --sound flag for task completion

packages/cli/assets/failure.mp3

@@ -98,7 +98,8 @@
   },
   "files": [
     "bin",
-    "build"
+    "build",
+    "assets"
   ],
   "scripts": {
     "lingo.dev": "node --inspect=9229 ./bin/cli.mjs",

packages/cli/assets/success.mp3

@@ -47,5 +47,6 @@ export const flagsSchema = z.object({
   targetLocale: z.array(z.string()).optional(),
   watch: z.boolean().default(false),
   debounce: z.number().positive().default(5000), // 5 seconds default
+  sound: z.boolean().optional(),
 });
 export type CmdRunFlags = z.infer<typeof flagsSchema>;

packages/cli/package.json

@@ -1,4 +1,8 @@
 import { Command } from "interactive-commander";
+import { exec } from "child_process";
+import path from "path";
+import { fileURLToPath } from "url";
+import os from "os";
 import setup from "./setup";
 import plan from "./plan";
 import execute from "./execute";
@@ -15,6 +19,44 @@ import {
 import trackEvent from "../../utils/observability";
 import { determineAuthId } from "./_utils";
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function playSound(type: "success" | "failure") {
+  const platform = os.platform();
+
+  return new Promise<void>((resolve) => {
+    const assetDir = path.join(__dirname, "../assets");
+    const soundFiles = [path.join(assetDir, `${type}.mp3`)];
+
+    let command = "";
+
+    if (platform === "linux") {
+      command = soundFiles
+        .map(
+          (file) =>
+            `mpg123 -q "${file}" 2>/dev/null || aplay "${file}" 2>/dev/null`,
+        )
+        .join(" || ");
+    } else if (platform === "darwin") {
+      command = soundFiles.map((file) => `afplay "${file}"`).join(" || ");
+    } else if (platform === "win32") {
+      command = `powershell -c "try { (New-Object Media.SoundPlayer '${soundFiles[1]}').PlaySync() } catch { Start-Process -FilePath '${soundFiles[0]}' -WindowStyle Hidden -Wait }"`;
+    } else {
+      command = soundFiles
+        .map(
+          (file) =>
+            `aplay "${file}" 2>/dev/null || afplay "${file}" 2>/dev/null`,
+        )
+        .join(" || ");
+    }
+
+    exec(command, () => {
+      resolve();
+    });
+    setTimeout(resolve, 3000);
+  });
+}
+
 export default new Command()
   .command("run")
   .description("Run Lingo.dev localization engine")
@@ -69,6 +111,10 @@ export default new Command()
     "Debounce delay in milliseconds for watch mode (default: 5000ms)",
     (val: string) => parseInt(val),
   )
+  .option(
+    "--sound",
+    "Play sound on completion, partially completion and failed of the task",
+  )
   .action(async (args) => {
     let authId: string | null = null;
     try {
@@ -107,6 +153,11 @@ export default new Command()
       await renderSummary(ctx.results);
       await renderSpacer();
 
+      // Play sound after main tasks complete if sound flag is enabled
+      if (ctx.flags.sound) {
+        await playSound("success");
+      }
+
       // If watch mode is enabled, start watching for changes
       if (ctx.flags.watch) {
         await watch(ctx);
@@ -118,6 +169,10 @@ export default new Command()
       });
     } catch (error: any) {
       await trackEvent(authId || "unknown", "cmd.run.error", {});
+      // Play sad sound if sound flag is enabled
+      if (args.sound) {
+        await playSound("failure");
+      }
       throw error;
     }
   });