add_tooltip.sh

#!/usr/bin/env bash
# add_tooltip.sh — Append a new placeholder tooltip entry to tooltips.json.
# Called by the bot admin panel "Add Tooltip (Script)" button, or manually.
#
# Usage:
#   ./add_tooltip.sh [--text "Custom tooltip text"]
#
# Outputs: new tooltip ID on stdout.
# On success exits 0; on failure exits non-zero.

set -euo pipefail

SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
APP_DIR="${RUNEWAGER_DIR:-$SCRIPT_DIR}"
DATA_DIR="$APP_DIR/data"
TOOLTIPS_FILE="$DATA_DIR/tooltips.json"
TMP_FILE="$TOOLTIPS_FILE.tmp.$$"

CUSTOM_TEXT=""
while [[ $# -gt 0 ]]; do
  case "$1" in
    --text) CUSTOM_TEXT="$2"; shift 2 ;;
    *) shift ;;
  esac
done

info()  { echo "[add_tooltip] INFO:  $*"; }
error() { echo "[add_tooltip] ERROR: $*" >&2; exit 1; }

mkdir -p "$DATA_DIR" || error "Cannot create data dir"

# Ensure tooltips.json exists
if [[ ! -f "$TOOLTIPS_FILE" ]]; then
  info "tooltips.json not found — initialising empty list"
  echo '[]' > "$TOOLTIPS_FILE"
fi

# Validate existing file
node -e "JSON.parse(require('fs').readFileSync('$TOOLTIPS_FILE','utf8'))" 2>/dev/null \
  || error "Existing $TOOLTIPS_FILE is not valid JSON"

TOOLTIP_TEXT="${CUSTOM_TEXT:-New tooltip — edit in admin panel via /tips.}"

# Append new entry and get new ID using Node.js
# Text and tmp path are passed via env vars to avoid shell injection on special characters
NEW_ID=$(TOOLTIP_TEXT_ENV="$TOOLTIP_TEXT" TOOLTIP_TMP_FILE="$TMP_FILE" node - "$TOOLTIPS_FILE" <<'EOF'
const fs = require('fs');
const file = process.argv[2];
const text = process.env.TOOLTIP_TEXT_ENV;
const tmpFile = process.env.TOOLTIP_TMP_FILE;
const list = JSON.parse(fs.readFileSync(file, 'utf8'));
if (!Array.isArray(list)) {
  throw new Error('tooltips.json must contain a JSON array');
}
// Only count entries that have a genuine finite numeric id
const numericIds = list
  .map((t) => (t && Object.prototype.hasOwnProperty.call(t, 'id') ? Number(t.id) : NaN))
  .filter((id) => Number.isFinite(id));
const maxId = numericIds.length ? Math.max(...numericIds) : 0;
const newId = maxId + 1;
list.push({ id: newId, text, enabled: true });
fs.writeFileSync(tmpFile, JSON.stringify(list, null, 2));
console.log(newId);
EOF
)

# Validate and move
node -e "JSON.parse(require('fs').readFileSync('$TMP_FILE','utf8'))" 2>/dev/null \
  || { rm -f "$TMP_FILE"; error "Generated JSON failed validation"; }

mv "$TMP_FILE" "$TOOLTIPS_FILE"
info "Added tooltip #${NEW_ID}: ${TOOLTIP_TEXT:0:60}"
echo "$NEW_ID"