NightSpire/web-next/lib/fulfill.ts

import { claimPaidCheckout } from './stripe'
import { getPaidService } from './paid-services'
import { markOrderPaid } from './battlepay'

export interface FulfillResult {
  ok: boolean
  service: string | null
  character: string | null
}

/**
 * Entrega un checkout pagado: reclama (atómico, una sola vez), resuelve el servicio
 * desde metadata.service y ejecuta su acción. Reutilizable por la página de éxito y
 * por el webhook, de modo que el pago se cumple aunque el usuario no vuelva.
 *
 * `fallbackService` permite a la página de éxito pasar el servicio de la URL para
 * sesiones antiguas cuyo metadata no lo incluía.
 */
export async function fulfillCheckoutSession(
  sessionId: string,
  fallbackService?: string,
): Promise<FulfillResult> {
  const claim = await claimPaidCheckout(sessionId)
  if (!claim) return { ok: false, service: fallbackService ?? null, character: null }

  // Rama Battlepay: marca la orden como PAID (el mod-battlepay la entrega en juego).
  if (claim.metadata.battlepay_reference) {
    const ok = await markOrderPaid(claim.metadata.battlepay_reference)
    return { ok, service: 'battlepay', character: null }
  }

  const service = claim.metadata.service || fallbackService || ''
  const cfg = service ? getPaidService(service) : null
  if (!cfg) return { ok: false, service: service || null, character: claim.characterName }

  const ok = await cfg.fulfill(claim.characterName, claim.metadata)
  return { ok, service, character: claim.characterName }
}