<?php

declare(strict_types=1);

if (!defined('ABSPATH')) {
  exit;
}

/**
 * Base API class for QuickBundles
 */
abstract class QBND_API
{
  /**
   * API namespace
   */
  protected string $namespace = 'qbnd/v1';

  /**
   * Resource name (to be defined by child classes)
   */
  protected string $resource_name = '';

  /**
   * Constructor
   */
  public function __construct()
  {
    add_action('rest_api_init', [$this, 'register_routes']);
  }

  /**
   * Register routes - to be implemented by child classes
   */
  abstract public function register_routes(): void;

  /**
   * Check if user has permission to manage bundles
   */
  public function can_manage_bundles(): bool
  {
    return current_user_can('manage_woocommerce');
  }

  /**
   * Check if user has permission to view bundles
   */
  public function can_view_bundles(): bool
  {
    return true; // Public access for viewing bundles
  }

  /**
   * Format error response
   */
  protected function error_response(string $message, int $status = 400): WP_Error
  {
    return new WP_Error(
      'qbnd_error',
      $message,
      ['status' => $status]
    );
  }

  /**
   * Validate required fields
   */
  protected function validate_required(array $data, array $required): ?WP_Error
  {
    foreach ($required as $field) {
      if (!isset($data[$field]) || empty($data[$field])) {
        return $this->error_response(
          sprintf(__('Missing required field: %s', 'quickbundles'), $field),
          400
        );
      }
    }
    return null;
  }
}