aboutsummaryrefslogtreecommitdiff
path: root/MediaBrowser.Controller/Library/ILocalSimilarItemsProvider.cs
blob: b8e41ec810d662d6befa7b12488da02d4fff578d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using MediaBrowser.Controller.Entities;

namespace MediaBrowser.Controller.Library;

/// <summary>
/// Provides similar items from the local library.
/// Returns fully resolved BaseItems directly - no additional resolution needed.
/// </summary>
public interface ILocalSimilarItemsProvider : ISimilarItemsProvider
{
    /// <summary>
    /// Determines whether the provider can handle items of the specified type.
    /// </summary>
    /// <param name="itemType">The item type.</param>
    /// <returns><c>true</c> if the provider handles this item type; otherwise <c>false</c>.</returns>
    bool Supports(Type itemType);

    /// <summary>
    /// Gets similar items from the local library.
    /// </summary>
    /// <param name="item">The source item to find similar items for.</param>
    /// <param name="query">The query options (user, limit, exclusions, etc.).</param>
    /// <param name="cancellationToken">Cancellation token.</param>
    /// <returns>The list of similar items from the library.</returns>
    Task<IReadOnlyList<BaseItem>> GetSimilarItemsAsync(
        BaseItem item,
        SimilarItemsQuery query,
        CancellationToken cancellationToken);
}

/// <summary>
/// Provides similar items from the local library for a specific item type.
/// Returns fully resolved BaseItems directly - no additional resolution needed.
/// </summary>
/// <typeparam name="TItemType">The type of item this provider handles.</typeparam>
public interface ILocalSimilarItemsProvider<TItemType> : ILocalSimilarItemsProvider
    where TItemType : BaseItem
{
    /// <summary>
    /// Gets similar items from the local library.
    /// </summary>
    /// <param name="item">The source item to find similar items for.</param>
    /// <param name="query">The query options (user, limit, exclusions, etc.).</param>
    /// <param name="cancellationToken">Cancellation token.</param>
    /// <returns>The list of similar items from the library.</returns>
    Task<IReadOnlyList<BaseItem>> GetSimilarItemsAsync(
        TItemType item,
        SimilarItemsQuery query,
        CancellationToken cancellationToken);

    bool ILocalSimilarItemsProvider.Supports(Type itemType)
        => typeof(TItemType).IsAssignableFrom(itemType);

    Task<IReadOnlyList<BaseItem>> ILocalSimilarItemsProvider.GetSimilarItemsAsync(
        BaseItem item,
        SimilarItemsQuery query,
        CancellationToken cancellationToken)
        => GetSimilarItemsAsync((TItemType)item, query, cancellationToken);
}