<?php
/**
 * Creates invoice and credit note records.
 *
 * At this stage an "invoice" is a set of order meta values (number, date,
 * type). The Factur-X PDF/XML generation will build on these records in the
 * next step, and a platform connector will transmit them after that.
 *
 * Type rules:
 * - B2B: the buyer gave a SIRET. Must be e-invoiced (from 1 Sept 2027 for SMEs).
 * - B2C: no SIRET. Not e-invoiced, but included in periodic e-reporting.
 *
 * @package EFactureFR
 */

defined( 'ABSPATH' ) || exit;

/**
 * Invoice manager.
 */
class EFacture_FR_Invoice_Manager {

	const META_NUMBER = '_efacture_fr_invoice_number';
	const META_DATE   = '_efacture_fr_invoice_date';
	const META_TYPE   = '_efacture_fr_invoice_type';
	const META_BUYER  = '_efacture_fr_buyer_ids';

	const META_CREDIT_NUMBER = '_efacture_fr_credit_note_number';
	const META_CREDIT_DATE   = '_efacture_fr_credit_note_date';
	const META_CREDIT_OF     = '_efacture_fr_credit_note_of';

	/**
	 * Hook in.
	 */
	public static function init() {
		add_action( 'woocommerce_order_status_processing', array( __CLASS__, 'maybe_create_on_processing' ), 20 );
		add_action( 'woocommerce_order_status_completed', array( __CLASS__, 'maybe_create_on_completed' ), 20 );
		add_action( 'woocommerce_order_refunded', array( __CLASS__, 'create_credit_note' ), 20, 2 );
	}

	/**
	 * Status hook: processing.
	 *
	 * @param int $order_id Order ID.
	 */
	public static function maybe_create_on_processing( $order_id ) {
		if ( 'processing' === EFacture_FR_Settings::get( 'trigger_status' ) ) {
			self::create_invoice( $order_id );
		}
	}

	/**
	 * Status hook: completed. Also catches orders that skipped "processing"
	 * (e.g. virtual products completed directly).
	 *
	 * @param int $order_id Order ID.
	 */
	public static function maybe_create_on_completed( $order_id ) {
		self::create_invoice( $order_id );
	}

	/**
	 * Create the invoice record once per order.
	 *
	 * @param int $order_id Order ID.
	 * @return string|null Invoice number, or null if not created.
	 */
	public static function create_invoice( $order_id ) {
		$order = wc_get_order( $order_id );
		if ( ! $order || $order instanceof WC_Order_Refund ) {
			return null;
		}

		$existing = (string) $order->get_meta( self::META_NUMBER );
		if ( '' !== $existing ) {
			return $existing;
		}

		$now    = time();
		$buyer  = EFacture_FR_Checkout_Fields::get_buyer_ids( $order );
		$type   = '' !== $buyer['siret'] ? 'B2B' : 'B2C';
		$number = EFacture_FR_Invoice_Numbering::next_formatted( $now );

		$order->update_meta_data( self::META_NUMBER, $number );
		$order->update_meta_data( self::META_DATE, gmdate( 'Y-m-d', $now ) );
		$order->update_meta_data( self::META_TYPE, $type );
		$order->update_meta_data( self::META_BUYER, $buyer );
		$order->save();

		/* translators: 1: invoice number, 2: B2B or B2C */
		$order->add_order_note( sprintf( __( 'Invoice %1$s created (%2$s).', 'factella' ), $number, $type ) );

		/**
		 * Fires after an invoice record is created. The Factur-X generator and
		 * platform connectors will listen to this.
		 *
		 * @param WC_Order $order  Order.
		 * @param string   $number Invoice number.
		 * @param string   $type   B2B or B2C.
		 */
		do_action( 'efacture_fr_invoice_created', $order, $number, $type );

		return $number;
	}

	/**
	 * Create a credit note for a refund.
	 *
	 * @param int $order_id  Order ID.
	 * @param int $refund_id Refund ID.
	 * @return string|null Credit note number, or null if not created.
	 */
	public static function create_credit_note( $order_id, $refund_id ) {
		$order  = wc_get_order( $order_id );
		$refund = wc_get_order( $refund_id );
		if ( ! $order || ! $refund ) {
			return null;
		}

		// A credit note only makes sense against an invoice.
		$invoice_number = (string) $order->get_meta( self::META_NUMBER );
		if ( '' === $invoice_number ) {
			return null;
		}

		$existing = (string) $refund->get_meta( self::META_CREDIT_NUMBER );
		if ( '' !== $existing ) {
			return $existing;
		}

		$now    = time();
		$number = EFacture_FR_Invoice_Numbering::next_formatted( $now );

		$refund->update_meta_data( self::META_CREDIT_NUMBER, $number );
		$refund->update_meta_data( self::META_CREDIT_DATE, gmdate( 'Y-m-d', $now ) );
		$refund->update_meta_data( self::META_CREDIT_OF, $invoice_number );
		$refund->save();

		/* translators: 1: credit note number, 2: invoice number */
		$order->add_order_note( sprintf( __( 'Credit note %1$s created for invoice %2$s.', 'factella' ), $number, $invoice_number ) );

		/**
		 * Fires after a credit note record is created.
		 *
		 * @param WC_Order        $order          Order.
		 * @param WC_Order_Refund $refund         Refund.
		 * @param string          $number         Credit note number.
		 * @param string          $invoice_number Invoice being credited.
		 */
		do_action( 'efacture_fr_credit_note_created', $order, $refund, $number, $invoice_number );

		return $number;
	}
}