/**
 * Generates an AI summary for our review text using the WordPress Abilities API.
 *
 * The Abilities API is a Script Module (`@wordpress/abilities`), so it must be
 * loaded via dynamic `import()` from classic scripts. Server-registered abilities
 * (like `ai/summarization`) are available when `@wordpress/core-abilities` is
 * enqueued, which WP 7.0 does on all admin pages.
 *
 * Falls back to `null` when the Abilities API or the ai/summarization ability
 * is not available.
 *
 * @param text The review text to summarize.
 * @return The generated summary, or null on failure.
 */
export async function generateSummary(
	text: string
): Promise< string | null > {
	try {
		const { executeAbility } = await import(
			/* webpackIgnore: true */ '@wordpress/abilities'
		);

		const result = await executeAbility( 'ai/summarization', {
			content: text,
			length: 'medium',
		} );
		return typeof result === 'string' && result.length > 0
			? result
			: null;
	} catch ( error ) {
		console.error( 'Error generating AI summary:', error );
		return null;
	}
}