messages.ts

/**
 * Centralized user-facing message catalog.
 *
 * Every string shown to the user (toasts, dialogs, inline errors) should come
 * from here so we have a single source of truth that is easy to translate later.
 *
 * Templates use `{param}` placeholders, resolved at call time by `msg()`.
 */

const messages = {
  // ── Git: general ──────────────────────────────────────────
  "git.commandFailed": "Git {command} failed: {detail}",

  // ── Git: branch / switch ──────────────────────────────────
  "git.switch.dirtyWorktree": "Cannot switch branches — commit or stash your changes first",

  // ── Git: commit ───────────────────────────────────────────
  "git.commit.failed": "Commit failed: {detail}",
  "git.commit.hookFailed": "Pre-commit hook failed",
  "git.hook.failed": "{hook} hook failed",

  // ── Git: push / sync ──────────────────────────────────────
  "git.push.failed": "Push failed: {detail}",
  "git.sync.failed": "Sync failed: {detail}",

  // ── Git: merge ────────────────────────────────────────────
  "git.merge.failed": "Merge failed",
  "git.merge.conflicts": "Merge has conflicts",
  "git.merge.conflictsDetail": "Merge has conflicts:\n{files}",
  "git.merge.finishFailed": "Could not complete the merge",
  "git.merge.abortFailed": "Could not abort the merge: {detail}",

  // ── Git: pull from source ─────────────────────────────────
  "git.pull.failed": "Pull failed: {detail}",
  "git.pull.localChanges": "Local changes need to be stashed before pulling from {branch}",
  "git.pull.reapplyConflicts": "Re-applying local changes has conflicts",
  "git.pull.stashPreserved":
    "Pull did not complete. Your local changes remain in a Lightcode stash.",

  // ── Git: worktree ─────────────────────────────────────────
  "git.worktree.noBranch": "Cannot create a default worktree path without a branch name",
  "git.worktree.dirtySource":
    "Branch '{branch}' has uncommitted changes in '{path}' — commit or stash them before merging",
  "git.worktree.cleanupFailed": "{original}\nWorktree cleanup also failed: {cleanup}",

  // ── Git: WSL ──────────────────────────────────────────────
  "git.wsl.homeNotFound": 'Unable to resolve home directory for WSL distro "{distro}"',
  "git.wsl.mkdirFailed": 'Unable to create WSL worktree directory "{path}"',

  // ── Git: PR ───────────────────────────────────────────────
  "git.pr.createFailed": "Failed to create pull request: {detail}",
  "git.pr.mergeFailed": "Failed to merge pull request: {detail}",
  "git.pr.closeFailed": "Failed to close pull request: {detail}",

  // ── Git: generate message ─────────────────────────────────
  "git.generateMessage.failed": "Could not generate commit message: {detail}",

  // ── Supervisor ────────────────────────────────────────────
  "supervisor.restarted": "Background process restarted",
  "supervisor.exited": "Background process exited unexpectedly",
  "supervisor.notRunning": "Background process is not running",

  // ── App update ────────────────────────────────────────────
  "update.error": "Update error: {detail}",
} as const;

// ---------------------------------------------------------------------------

/** Union of every known message key. */
export type MessageKey = keyof typeof messages;

/**
 * Look up a user-facing message by key with optional `{param}` interpolation.
 *
 * ```ts
 * msg("git.merge.conflictsDetail", { files: "src/index.ts\nREADME.md" })
 * // → "Merge has conflicts:\nsrc/index.ts\nREADME.md"
 * ```
 */
export function msg(key: MessageKey, params?: Record<string, string | number>): string {
  let text: string = messages[key];
  if (params) {
    for (const [k, v] of Object.entries(params)) {
      text = text.replaceAll(`{${k}}`, String(v));
    }
  }
  return text;
}

/**
 * Extract the raw message string from an unknown caught value.
 *
 * Use this for `console.error` logging or when you need the unmodified detail.
 * For user-facing toasts, prefer {@link friendlyError} instead.
 */
export function errorDetail(err: unknown): string {
  return err instanceof Error ? err.message : String(err);
}

// ---------------------------------------------------------------------------
// Pattern → friendly message mapping (for user-facing toasts)
// ---------------------------------------------------------------------------

/**
 * Each entry is a regex tested against the raw error string and the
 * message key (+ optional param extractor) to use when it matches.
 * Order matters — first match wins.
 */
const errorPatterns: Array<{
  test: RegExp;
  key: MessageKey;
  params?: (raw: string) => Record<string, string>;
}> = [
  {
    test: /local changes.*would be overwritten/i,
    key: "git.switch.dirtyWorktree",
  },
  {
    test: /not fully merged/i,
    key: "git.merge.failed",
  },
  {
    test: /CONFLICT|Merge conflict/,
    key: "git.merge.conflicts",
  },
];

/** Strip Electron IPC wrapper noise from error messages. */
function stripIpcPrefix(raw: string): string {
  return raw.replace(/^Error invoking remote method '[^']+': Error:\s*/i, "");
}

/**
 * Sentinel used to ferry an extra "details" block (typically full stderr)
 * inside the single-string error channel between supervisor → main → renderer.
 * Null bytes do not appear in legitimate error messages, so the marker is
 * collision-safe against real content.
 */
const DETAILS_SENTINEL = "__LC_DETAILS__";

/** Append a details block to an error summary so the renderer can disclose it. */
export function attachErrorDetails(summary: string, details: string): string {
  if (!details) return summary;
  return `${summary}${DETAILS_SENTINEL}${details}`;
}

/** Split a raw error string into `{ summary, details }`. */
function splitErrorDetails(raw: string): { summary: string; details: string } {
  const idx = raw.indexOf(DETAILS_SENTINEL);
  if (idx < 0) return { summary: raw, details: "" };
  return {
    summary: raw.slice(0, idx),
    details: raw.slice(idx + DETAILS_SENTINEL.length),
  };
}

const HOOK_PATH_RX = /\.husky\/([\w.-]+)|\.git\/hooks\/([\w.-]+)/;

/**
 * Detect whether a stderr blob looks like output from a failed git hook.
 * Husky prints `husky - <hook> hook exited with code N` on failure, and
 * git itself emits paths under `.husky/` or `.git/hooks/` when invoking
 * scripts.
 */
function detectHookFailure(stderr: string): { hook: string } | null {
  if (!stderr) return null;
  const huskyMatch = stderr.match(/husky\s*-\s*([\w.-]+)\s+hook/i);
  if (huskyMatch?.[1]) return { hook: huskyMatch[1] };
  const pathMatch = stderr.match(HOOK_PATH_RX);
  if (pathMatch) return { hook: pathMatch[1] ?? pathMatch[2] ?? "pre-commit" };
  if (/hook .* (failed|exited)/i.test(stderr)) return { hook: "pre-commit" };
  return null;
}

/**
 * Turn an unknown caught error into a short, user-friendly toast string.
 *
 * 1. Extracts the raw message.
 * 2. Strips Electron IPC wrapper noise.
 * 3. Drops any attached details block (use {@link friendlyErrorWithDetail} to keep it).
 * 4. Matches against known patterns → returns a catalog message.
 * 5. Falls back to the stripped raw string for unknown errors.
 */
export function friendlyError(err: unknown): string {
  return friendlyErrorWithDetail(err).summary;
}

/**
 * Same as {@link friendlyError} but also returns any attached stderr/details
 * block so callers can render it in a toast description or "Show details"
 * disclosure. Hook failures are summarized as "Pre-commit hook failed" with
 * the raw bash noise kept in `details`.
 */
export function friendlyErrorWithDetail(err: unknown): { summary: string; details: string } {
  const raw = stripIpcPrefix(errorDetail(err));
  const { summary: rawSummary, details } = splitErrorDetails(raw);

  const hook = detectHookFailure(details || rawSummary);
  if (hook) {
    const summary =
      hook.hook === "pre-commit" || !hook.hook
        ? msg("git.commit.hookFailed")
        : msg("git.hook.failed", { hook: hook.hook });
    return { summary, details: details || rawSummary };
  }

  for (const pattern of errorPatterns) {
    if (pattern.test.test(rawSummary)) {
      return { summary: msg(pattern.key, pattern.params?.(rawSummary)), details };
    }
  }

  return { summary: rawSummary, details };
}