Interface ICharacterAbilityService

Namespace

FishMMO.Database.Npgsql.Services.Interfaces

Assembly

FishMMO-DB.dll

Service interface for managing character abilities.

public interface ICharacterAbilityService : ICountByKeyAction<long>, IPersistAction<CharacterAbilityData, long>, IPersistManyAction<CharacterAbilityData>, IDeleteByKeyVersionedAction<long>, IFetchCollectionByKeyAction<long, CharacterAbilityData>

Inherited Members

ICountByKeyAction<long>.CountAsync(long, CancellationToken)

IPersistAction<CharacterAbilityData, long>.PersistAsync(CharacterAbilityData, CancellationToken)

IPersistManyAction<CharacterAbilityData>.PersistAsync(IEnumerable<CharacterAbilityData>, CancellationToken)

IDeleteByKeyVersionedAction<long>.DeleteAsync(long, long, CancellationToken)

IFetchCollectionByKeyAction<long, CharacterAbilityData>.FetchAsync(long, CancellationToken)

Remarks

Ability persistence and deletion should be version-gated via the logical Version so stale updates are rejected and newer authoritative updates win.

Methods

DeleteAsync(long, long, long, CancellationToken)

Deletes a single ability record for a character if incomingVersion is newer.

Task<DatabaseResult> DeleteAsync(long characterId, long abilityId, long incomingVersion, CancellationToken cancellationToken = default)

Parameters

characterId long

The character ID that owns the ability.

abilityId long

The ability identifier.

incomingVersion long

The authoritative, monotonic version for this delete operation.

cancellationToken CancellationToken

Token to cancel the operation.

Returns

Task<DatabaseResult>

A DatabaseResult indicating success or failure.