<?php
/**
 * Sources — family-plugin data sources for selective backup/restore.
 *
 * Any AtoZ plugin can register a source via the `atoz_backup_sources` filter,
 * returning an export callable (→ bytes) and an import callable (bytes →). This
 * lets AI-SiteArk back up / restore just one plugin's data (e.g. AI-Inquiro
 * leads) independently of a full-site backup.
 *
 * @package AI_SiteArk
 * Copyright (c) 2026 AtoZ INFOWAY INC.
 * Licensed under the GNU General Public License, version 2 or later.
 */

namespace AtoZ\SiteArk\Helpers;

defined( 'ABSPATH' ) || exit;

/**
 * Class Sources
 */
class Sources {

	/**
	 * All registered, valid sources keyed by slug.
	 *
	 * @return array<string,array{slug:string,label:string,export:callable,import:callable|null}>
	 */
	public static function all() {
		$raw = apply_filters( 'atoz_backup_sources', array() );
		$out = array();
		foreach ( (array) $raw as $s ) {
			if ( empty( $s['slug'] ) || empty( $s['export'] ) || ! is_callable( $s['export'] ) ) {
				continue;
			}
			$slug         = sanitize_key( $s['slug'] );
			$out[ $slug ] = array(
				'slug'   => $slug,
				'label'  => isset( $s['label'] ) ? (string) $s['label'] : $slug,
				'export' => $s['export'],
				'import' => ( ! empty( $s['import'] ) && is_callable( $s['import'] ) ) ? $s['import'] : null,
			);
		}
		return $out;
	}

	/**
	 * A single source by slug.
	 *
	 * @param string $slug Slug.
	 * @return array|null
	 */
	public static function get( $slug ) {
		$all = self::all();
		return $all[ sanitize_key( $slug ) ] ?? null;
	}
}