oopsx 1.0.0 → 1.1.0

package/README.md

@@ -1,139 +1,27 @@
-# merr
+# oopsx
 
-> Play a meme sound when your terminal command fails.
+Play a meme sound when your terminal command fails. Comes with a default sound out of the box.
 
-Ever wish your terminal could roast you for typos and bad commands? **merr** wraps any shell command and plays a sound when it exits with a non-zero code. Pick your own meme sound, or use the default.
-
-```
-$ merr git puhs origin main
-fatal: 'puhs' is not a git command.
-🔊 *sad trombone plays*
-```
-
----
-
-## Installation
-
-### npx (zero install)
+## Install
 
 ```bash
-npx merr ls /nonexistent/path
+npm install -g oopsx
 ```
 
-### Global install via npm
+Restart your terminal. Every failed command now plays a sound.
 
-```bash
-npm install -g merr
-```
-
-### Curl install (macOS / Linux)
+## Custom sound
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/devesh760/merr/main/install.sh | bash
+oopsx --sound ~/bruh.mp3 --set-default echo hi
 ```
 
----
-
-## Usage
-
-```bash
-# Basic — plays default sound on failure
-merr ls /does/not/exist
-
-# Use a custom local sound
-merr --sound ~/sounds/bruh.mp3 make build
-
-# Use a sound from a URL (cached automatically)
-merr --url https://example.com/fail.mp3 npm test
-
-# Set volume (0–100)
-merr --volume 50 python script.py
-
-# Save a sound as the new default
-merr --sound ~/sounds/oof.mp3 --set-default echo "saved!"
-
-# Play sound only once per shell session
-merr --once cargo build
-```
-
-### CLI Options
-
-| Option              | Description                                    |
-| ------------------- | ---------------------------------------------- |
-| `--sound <path>`    | Use a local `.mp3` or `.wav` file              |
-| `--url <url>`       | Download and cache a sound from a URL          |
-| `--volume <0-100>`  | Playback volume (default: `80`)                |
-| `--set-default`     | Persist the resolved sound as the new default  |
-| `--once`            | Play sound only once per shell session         |
-
----
-
-## How It Works
-
-1. **merr** runs your command with inherited stdio (you see all output as normal).
-2. If the command exits with code `0` — nothing happens.
-3. If the command exits with a non-zero code — merr plays a sound.
-4. merr then exits with the **same exit code** as the original command.
-
-### Sound Resolution Priority
-
-1. `--sound <path>` — explicit local file
-2. `--url <url>` — downloads and caches the file under `~/.merr/sounds/`
-3. Default sound at `~/.merr/default.mp3`
-
----
-
-## Custom Sound Examples
-
-```bash
-# Sad trombone on test failure
-merr --sound ~/memes/sad-trombone.mp3 npm test
-
-# Windows XP error from a URL
-merr --url "https://example.com/xp-error.mp3" cargo build
-
-# Set a default once, use it everywhere
-merr --sound ~/memes/bruh.mp3 --set-default echo "done"
-merr npm test  # now uses bruh.mp3 automatically
-```
-
----
-
-## Config
-
-merr stores configuration in `~/.merr/`:
-
-```
-~/.merr/
-├── config.json       # volume and preferences
-├── default.mp3       # default sound file
-└── sounds/           # cached URL downloads (hashed filenames)
-```
-
----
-
-## Platform Support
-
-| Platform | Player Backend         |
-| -------- | ---------------------- |
-| macOS    | `afplay` (built-in)    |
-| Linux    | `aplay` / `mpg123`     |
-| Windows  | PowerShell fallback    |
-
----
-
 ## Uninstall
 
 ```bash
-# Remove the CLI
-npm uninstall -g merr
-
-# Remove config and cached sounds
-rm -rf ~/.merr
+npm uninstall -g oopsx
 ```
 
----
-
 ## License
 
 MIT

package/bin/merr.js

@@ -1,19 +1,145 @@
 #!/usr/bin/env node
 
+import { existsSync, readFileSync, appendFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
 import { Command } from "commander";
 import { runCommand } from "../src/runner.js";
 import { resolveSound, playAudio, setDefault, setVolume } from "../src/sound.js";
 import { readConfig } from "../src/config.js";
 
-const SESSION_KEY = `MERR_PLAYED_${process.ppid}`;
+const HOOK_MARKER = "# oopsx shell hook";
+
+const getShellRc = () => {
+  const shell = (process.env.SHELL || "").toLowerCase();
+  if (shell.endsWith("zsh")) return { file: join(homedir(), ".zshrc"), type: "zsh" };
+  if (shell.endsWith("bash")) return { file: join(homedir(), ".bashrc"), type: "bash" };
+  return null;
+};
+
+const hookSnippet = (type) => {
+  if (type === "zsh") {
+    return `
+${HOOK_MARKER}
+eval "$(oopsx init zsh)"`;
+  }
+  return `
+${HOOK_MARKER}
+eval "$(oopsx init bash)"`;
+};
+
+const SESSION_KEY = `OOPSX_PLAYED_${process.ppid}`;
 
 const program = new Command();
 
 program
-  .name("merr")
+  .name("oopsx")
   .description("Play a meme sound when your terminal command fails")
-  .version("1.0.0")
-  .argument("<command...>", "Shell command to execute")
+  .version("1.0.0");
+
+// --- `oopsx init <shell>` — output shell hook snippet ---
+program
+  .command("init <shell>")
+  .description("Print shell hook to auto-play sound on errors (zsh or bash)")
+  .action((shell) => {
+    const normalized = shell.toLowerCase().trim();
+
+    if (normalized === "zsh") {
+      console.log(`
+__oopsx_precmd() {
+  local exit_code=$?
+  [[ $exit_code -ne 0 ]] && (oopsx play &>/dev/null &)
+  return $exit_code
+}
+precmd_functions+=(__oopsx_precmd)
+`.trim());
+    } else if (normalized === "bash") {
+      console.log(`
+__oopsx_prompt_command() {
+  local exit_code=$?
+  [[ $exit_code -ne 0 ]] && (oopsx play &>/dev/null &)
+  return $exit_code
+}
+PROMPT_COMMAND="__oopsx_prompt_command;\${PROMPT_COMMAND}"
+`.trim());
+    } else {
+      console.error(`Unsupported shell: ${shell}. Use "zsh" or "bash".`);
+      process.exit(1);
+    }
+  });
+
+// --- `oopsx setup` — auto-add hook to shell rc file ---
+program
+  .command("setup")
+  .description("Automatically add the shell hook to your .zshrc or .bashrc")
+  .action(() => {
+    const rc = getShellRc();
+    if (!rc) {
+      console.error("Could not detect your shell. Manually add: eval \"$(oopsx init zsh)\" to your rc file.");
+      process.exit(1);
+    }
+
+    if (existsSync(rc.file)) {
+      const contents = readFileSync(rc.file, "utf-8");
+      if (contents.includes(HOOK_MARKER)) {
+        console.log(`Already set up in ${rc.file}`);
+        return;
+      }
+    }
+
+    appendFileSync(rc.file, hookSnippet(rc.type), "utf-8");
+    console.log(`✓ Added oopsx hook to ${rc.file}`);
+    console.log(`  Open a new terminal tab to activate, or run:\n\n  source ${rc.file}\n`);
+  });
+
+// --- `oopsx remove` — remove hook from shell rc file ---
+program
+  .command("remove")
+  .description("Remove the shell hook from your .zshrc or .bashrc")
+  .action(() => {
+    const rc = getShellRc();
+    if (!rc || !existsSync(rc.file)) {
+      console.log("Nothing to remove.");
+      return;
+    }
+
+    const contents = readFileSync(rc.file, "utf-8");
+    if (!contents.includes(HOOK_MARKER)) {
+      console.log("No oopsx hook found in " + rc.file);
+      return;
+    }
+
+    const cleaned = contents
+      .split("\n")
+      .filter((line) => !line.includes("oopsx") && line !== HOOK_MARKER)
+      .join("\n");
+
+    writeFileSync(rc.file, cleaned, "utf-8");
+    console.log(`Removed oopsx hook from ${rc.file}`);
+    console.log("Restart your terminal or run: source " + rc.file);
+  });
+
+// --- `oopsx play` — just play the sound (used by shell hook) ---
+program
+  .command("play")
+  .description("Play the error sound (used internally by the shell hook)")
+  .action(async () => {
+    const config = readConfig();
+    const soundFile = await resolveSound({});
+
+    if (!soundFile) process.exit(0);
+
+    try {
+      await playAudio(soundFile, config.volume ?? 80);
+    } catch {
+      // silent — this runs in background, don't pollute the terminal
+    }
+  });
+
+// --- `oopsx run <command...>` — wrap a single command (original behavior) ---
+program
+  .command("run <command...>", { isDefault: true })
+  .description("Execute a command and play sound on failure")
   .option("--sound <path>", "Use a local sound file (mp3/wav)")
   .option("--url <url>", "Download and cache a sound from a URL")
   .option("--volume <number>", "Playback volume 0–100", parseInt)
@@ -24,7 +150,6 @@ program
     const config = readConfig();
     const volume = options.volume ?? config.volume ?? 80;
 
-    // Persist volume if explicitly provided
     if (options.volume !== undefined) {
       setVolume(options.volume);
     }
@@ -35,7 +160,6 @@ program
       process.exit(0);
     }
 
-    // --once: skip if already played in this shell session
     if (options.once && process.env[SESSION_KEY]) {
       process.exit(exitCode);
     }
@@ -46,7 +170,6 @@ program
       process.exit(exitCode);
     }
 
-    // --set-default: persist the resolved sound
     if (options.setDefault) {
       setDefault(soundFile);
     }
@@ -57,7 +180,6 @@ program
       console.error(`Sound playback failed: ${err.message}`);
     }
 
-    // Mark as played for --once (only useful if parent reads env, but we set it anyway)
     if (options.once) {
       process.env[SESSION_KEY] = "1";
     }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "oopsx",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Play a meme sound when your terminal command fails",
   "type": "module",
   "bin": {
-    "merr": "./bin/merr.js"
+    "oopsx": "./bin/merr.js"
   },
   "engines": {
     "node": ">=18"
@@ -26,11 +26,15 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/devesh760/merr.git"
+    "url": "git+https://github.com/devesh760/oopsx.git"
   },
-  "homepage": "https://github.com/devesh760/merr#readme",
+  "homepage": "https://github.com/devesh760/oopsx#readme",
   "bugs": {
-    "url": "https://github.com/devesh760/merr/issues"
+    "url": "https://github.com/devesh760/oopsx/issues"
+  },
+  "scripts": {
+    "postinstall": "node bin/merr.js setup",
+    "preuninstall": "node bin/merr.js remove && rm -rf ~/.merr"
   },
   "dependencies": {
     "commander": "^12.1.0",