cloudinary-8.x-1.x-dev/modules/cloudinary_media_library_widget/src/Plugin/CloudinaryMediaPluginInterface.php

<?php

namespace Drupal\cloudinary_media_library_widget\Plugin;

use Drupal\cloudinary_media_library_widget\Model\Asset;
use Drupal\Component\Plugin\PluginInspectionInterface;
use Drupal\media\MediaInterface;

/**
 * Defines the interface for Cloudinary media plugins.
 *
 * @deprecated in cloudinary:3.0.0 and is removed from cloudinary:4.0.0. Use
 *   a dedicated source plugin instead.
 *
 * @see https://www.drupal.org/project/cloudinary/issues/3314722
 */
interface CloudinaryMediaPluginInterface extends PluginInspectionInterface {

  /**
   * Find Drupal media entity.
   *
   * @param \Drupal\cloudinary_media_library_widget\Model\Asset $asset
   *   Cloudinary asset.
   * @param string $bundle
   *   Media entity bundle.
   *
   * @return \Drupal\media\MediaInterface|null
   *   Drupal media entity.
   */
  public function findMedia(Asset $asset, string $bundle): ?MediaInterface;

  /**
   * Create media entity.
   *
   * @param \Drupal\cloudinary_media_library_widget\Model\Asset $asset
   *   Cloudinary asset.
   * @param string $bundle
   *   Media entity bundle.
   *
   * @return \Drupal\media\MediaInterface
   *   Cloudinary media entity.
   */
  public function createMedia(Asset $asset, string $bundle): MediaInterface;

}