<?php
declare(strict_types=1);
// ==================================================
// Nuclear Fancy Pants Edition™ — NUCLEAR+++
// File: /home/ploi/automarketer-ai.com/public/wp-content/plugins/automarketer-ai/includes/image-provider-interface.php
// Description: Contract for image generation provider modules - NUCLEAR+++
// Last Edited: 2026-04-09
// ==================================================

namespace AutoMarketerAI;

if (!defined('ABSPATH')) {
    exit('No direct script access allowed.');
}

interface ImageProviderInterface extends ModuleInterface
{
    // Generate an image from a text prompt using the provider API.
    // Downloads the result to the WP media library.
    // Returns a local attachment URL on success, null on any failure.
    // $api_key is the already-decrypted raw API key.
    public function generate_image(string $prompt, string $api_key): ?string;
}