class IProductsRepository[T: Product](Protocol):
	async def get(self, id: int) -> T | None: ...

	class _SearchFilterOptions(TypedDict, total=False):
		category: Literal["name", "acronym", "exhibition_name"]
		name: str
		visible: bool
		sellable: bool
		product_type_id: int
		product_list: list[int]
		page: int
		page_limit: int

	async def search(self, options: _SearchFilterOptions) -> list[T]:
		"""
		Search/list products based on the provided filter options.

		Supports both specific search (by category and name) and general listing with filters.
		If category and name are provided, performs specific search.
		Otherwise, lists all products matching the filter criteria.

		### Args:
		- options (_SearchFilterOptions): The search filter options:
		```python
		{
			"category": "name" | "acronym" | "exhibition_name" # (optional for listing),
			"name": "Product Name" # (optional for listing, required if category is provided),
			"visible": True | False,
			"sellable": True | False,
			"product_type_id": int,
			"product_list": list[int],
			"page": int,
			"page_limit": int,
		}
		```

		### Returns:
			list[T]: A list of products that match the search/filter criteria.
		"""
		...