archy/neode-ui/src/composables/useLightningRequired.ts

// Shared "this action needs a working Lightning node" gate (2026-08-02).
//
// Creating a Lightning invoice used to fail at the RPC layer whenever this
// node had no usable Lightning implementation — `lnd.createinvoice` returned
// connection-refused and the Receive screen rendered "Operation failed. Check
// server logs for details." That reads as the wallet being broken, when the
// truth is a missing (or stopped) prerequisite the user can act on.
//
// Callers ask `requireLightningNode()` BEFORE attempting the call. When there
// is no usable node it opens the global LightningRequiredModal and returns
// false, so the caller bails without surfacing an error at all.
//
// Keyed on package STATE, not mere presence: `package-data` carries an entry
// for a Lightning app that is known to this node but not actually running, so
// `id in packages` is NOT "installed and usable" — that assumption was the
// first version's bug, and it let the raw RPC error through on a node with no
// lnd container at all.
import { ref } from 'vue'
import { useAppStore } from '@/stores/app'
import { PackageState } from '@/types/api'

/** Package ids that provide a Lightning node.
 *
 * `lnd` ships today. Core Lightning is the next implementation the modal
 * offers — when its app id lands in the catalog, add it here and flip its
 * `available` flag in LightningRequiredModal; nothing else changes. */
export const LIGHTNING_NODE_APP_IDS = ['lnd'] as const

/** `absent` — nothing installed, offer to install one.
 *  `stopped` — installed but not running, point the user at My Apps.
 *  `running` — good to go. */
export type LightningStatus = 'absent' | 'stopped' | 'running'

// Module-scope: one source of truth shared by every caller and the single
// global modal mounted in App.vue.
const show = ref(false)
const status = ref<LightningStatus>('absent')

export function useLightningRequired() {
  const appStore = useAppStore()

  /** Best status across every known Lightning implementation. */
  function lightningStatus(): LightningStatus {
    const pkgs = (appStore.packages ?? {}) as Record<string, { state?: string } | undefined>
    let best: LightningStatus = 'absent'
    for (const id of LIGHTNING_NODE_APP_IDS) {
      const entry = pkgs[id]
      if (!entry) continue
      if (entry.state === PackageState.Running) return 'running'
      // Present but not running: installing, starting, stopped, exited…
      best = 'stopped'
    }
    return best
  }

  function hasLightningNode(): boolean {
    return lightningStatus() === 'running'
  }

  /**
   * Gate a Lightning-only action. Returns true to proceed; returns false and
   * opens the modal (in the mode matching why) when there is no usable node.
   */
  function requireLightningNode(): boolean {
    const s = lightningStatus()
    if (s === 'running') return true
    status.value = s
    show.value = true
    return false
  }

  function close() {
    show.value = false
  }

  return { show, status, lightningStatus, hasLightningNode, requireLightningNode, close }
}