1	<?php
2
3	namespace App\Http\Repositories\interfaces;
4
5	use App\Http\Models\PromptPersonalMilestone;
6	use Illuminate\Support\Collection;
7
8	/**
9	* Interface for prompt personal milestone data access operations.
10	*
11	* Abstracts prompt personal milestone database queries, providing methods
12	* to manage "celebrate" post options used by post AI features.
13	*/
14	interface IPromptPersonalMilestoneRepository
15	{
16	/**
17	* Get all prompt personal milestones ordered by newest first.
18	*
19	* @return Collection<int, PromptPersonalMilestone> Collection of milestones
20	*/
21	public function getAll(): Collection;
22
23	/**
24	* Find a prompt personal milestone by its ID.
25	*
26	* @param  string  $id  The milestone ID
27	* @return PromptPersonalMilestone|null The milestone or null if not found
28	*/
29	public function findById(string $id): ?PromptPersonalMilestone;
30
31	/**
32	* Create a new prompt personal milestone.
33	*
34	* @param  array{title: string, prompt: string}  $data  The milestone data
35	* @return PromptPersonalMilestone The created milestone
36	*/
37	public function create(array $data): PromptPersonalMilestone;
38
39	/**
40	* Update an existing prompt personal milestone.
41	*
42	* @param  PromptPersonalMilestone  $promptPersonalMilestone  The milestone to update
43	* @param  array{title?: string, prompt?: string}  $data  The update data
44	* @return PromptPersonalMilestone The updated milestone
45	*/
46	public function update(PromptPersonalMilestone $promptPersonalMilestone, array $data): PromptPersonalMilestone;
47
48	/**
49	* Delete a prompt personal milestone.
50	*
51	* @param  PromptPersonalMilestone  $promptPersonalMilestone  The milestone to delete
52	* @return bool True if deleted successfully
53	*/
54	public function delete(PromptPersonalMilestone $promptPersonalMilestone): bool;
55	}