@prdb/sdk 0.6.1 → 0.7.0

package/dist/generated/models/index.d.ts

@@ -1,19 +1,22 @@
 import { type AdditionalDataHolder, type ApiError, type DateOnly, type Guid, type Parsable, type ParseNode, type SerializationWriter } from '@microsoft/kiota-abstractions';
+/**
+ * An active subscription held by the authenticated user.
+ */
 export interface ActiveSubscriptionDto extends AdditionalDataHolder, Parsable {
     /**
-     * The endsAtUtc property
+     * UTC timestamp when this subscription period ends.
      */
     endsAtUtc?: Date | null;
     /**
-     * The packageIdentifier property
+     * Stable slug identifying the subscription package (e.g. "plus", "premium").
      */
     packageIdentifier?: string | null;
     /**
-     * The packageTitle property
+     * Human-readable title of the subscription package.
      */
     packageTitle?: string | null;
     /**
-     * The startsAtUtc property
+     * UTC timestamp when this subscription period starts.
      */
     startsAtUtc?: Date | null;
 }
@@ -23,7 +26,7 @@ export interface ActorAliasDto extends AdditionalDataHolder, Parsable {
      */
     name?: string | null;
     /**
-     * The siteId property
+     * ID of the site this alias is associated with, if any.
      */
     siteId?: Guid | null;
 }
@@ -37,6 +40,9 @@ export interface ActorBioDto extends AdditionalDataHolder, Parsable {
      */
     text?: string | null;
 }
+/**
+ * Full current actor payload, including tombstone metadata.
+ */
 export interface ActorChangeActorDto extends AdditionalDataHolder, Parsable {
     /**
      * The aliases property
@@ -203,13 +209,16 @@ export interface ActorChangeBioDto extends AdditionalDataHolder, Parsable {
      */
     text?: string | null;
 }
+/**
+ * A single current-state actor change.
+ */
 export interface ActorChangeDto extends AdditionalDataHolder, Parsable {
     /**
-     * The actor property
+     * Full current actor payload, including tombstone metadata.
      */
     actor?: ActorChangeActorDto | null;
     /**
-     * The eventType property
+     * One of `created`, `updated`, or `deleted`.
      */
     eventType?: string | null;
 }
@@ -227,7 +236,7 @@ export interface ActorChangeImageDto extends AdditionalDataHolder, Parsable {
      */
     imageTypeLabel?: string | null;
     /**
-     * The url property
+     * Absolute URL for the image, if available: a complete URL including scheme and host, ready torequest as-is.
      */
     url?: string | null;
 }
@@ -245,6 +254,9 @@ export interface ActorChangeLinkDto extends AdditionalDataHolder, Parsable {
      */
     url?: string | null;
 }
+/**
+ * Seek cursor for continuing an actor change feed.
+ */
 export interface ActorChangesCursorDto extends AdditionalDataHolder, Parsable {
     /**
      * The id property
@@ -255,6 +267,9 @@ export interface ActorChangesCursorDto extends AdditionalDataHolder, Parsable {
      */
     updatedAtUtc?: Date | null;
 }
+/**
+ * Full details for a single actor.
+ */
 export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
     /**
      * The aliases property
@@ -265,7 +280,7 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     bios?: ActorBioDto[] | null;
     /**
-     * The birthday property
+     * Date of birth, if known.
      */
     birthday?: DateOnly | null;
     /**
@@ -273,7 +288,7 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     birthdayType?: number | null;
     /**
-     * The birthdayTypeLabel property
+     * Human-readable birthday type label (e.g. "Exact", "Approximate").
      */
     birthdayTypeLabel?: string | null;
     /**
@@ -285,7 +300,7 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     braSize?: number | null;
     /**
-     * The braSizeLabel property
+     * Human-readable bra size label (e.g. "34B").
      */
     braSizeLabel?: string | null;
     /**
@@ -297,11 +312,11 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     breastTypeLabel?: string | null;
     /**
-     * The careerEnd property
+     * Year the actor's career ended, if applicable.
      */
     careerEnd?: number | null;
     /**
-     * The careerStart property
+     * Year the actor's career began.
      */
     careerStart?: number | null;
     /**
@@ -309,7 +324,7 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     createdAtUtc?: Date | null;
     /**
-     * The deathday property
+     * Date of death, if applicable.
      */
     deathday?: DateOnly | null;
     /**
@@ -333,7 +348,7 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     gender?: number | null;
     /**
-     * The genderLabel property
+     * Human-readable gender label.
      */
     genderLabel?: string | null;
     /**
@@ -345,11 +360,11 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     haircolorLabel?: string | null;
     /**
-     * The height property
+     * Height in centimetres.
      */
     height?: number | null;
     /**
-     * The hipSize property
+     * Hip measurement in centimetres.
      */
     hipSize?: number | null;
     /**
@@ -365,7 +380,7 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     links?: ActorLinkDto[] | null;
     /**
-     * The name property
+     * Stage name of the actor.
      */
     name?: string | null;
     /**
@@ -389,7 +404,7 @@ export interface ActorDetailDto extends AdditionalDataHolder, Parsable {
      */
     updatedAtUtc?: Date | null;
     /**
-     * The waistSize property
+     * Waist measurement in centimetres.
      */
     waistSize?: number | null;
 }
@@ -407,7 +422,7 @@ export interface ActorImageDetailDto extends AdditionalDataHolder, Parsable {
      */
     imageTypeLabel?: string | null;
     /**
-     * The url property
+     * Absolute URL for the image, if available: a complete URL including scheme and host, ready torequest as-is.
      */
     url?: string | null;
 }
@@ -425,9 +440,12 @@ export interface ActorLinkDto extends AdditionalDataHolder, Parsable {
      */
     url?: string | null;
 }
+/**
+ * Summary of a single actor.
+ */
 export interface ActorSummaryDto extends AdditionalDataHolder, Parsable {
     /**
-     * The birthday property
+     * Date of birth, if known.
      */
     birthday?: DateOnly | null;
     /**
@@ -435,7 +453,7 @@ export interface ActorSummaryDto extends AdditionalDataHolder, Parsable {
      */
     ethnicity?: number | null;
     /**
-     * The ethnicityLabel property
+     * Human-readable ethnicity label.
      */
     ethnicityLabel?: string | null;
     /**
@@ -443,7 +461,7 @@ export interface ActorSummaryDto extends AdditionalDataHolder, Parsable {
      */
     gender?: number | null;
     /**
-     * The genderLabel property
+     * Human-readable gender label.
      */
     genderLabel?: string | null;
     /**
@@ -451,7 +469,7 @@ export interface ActorSummaryDto extends AdditionalDataHolder, Parsable {
      */
     id?: Guid | null;
     /**
-     * The name property
+     * Stage name of the actor.
      */
     name?: string | null;
     /**
@@ -459,43 +477,43 @@ export interface ActorSummaryDto extends AdditionalDataHolder, Parsable {
      */
     nationality?: number | null;
     /**
-     * The nationalityLabel property
+     * Human-readable nationality label.
      */
     nationalityLabel?: string | null;
     /**
-     * The profileImageUrl property
+     * Absolute URL of the actor's profile image, if available: a complete URL including scheme andhost, ready to request as-is.
      */
     profileImageUrl?: string | null;
 }
 export interface AddDownloadedFromIndexerFilenameRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The filename property
+     * The filename as reported by the indexer/download source.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * File size in bytes.
      */
     filesize?: number | null;
     /**
-     * The osHash property
+     * Optional OS hash value as a 16-character fixed-length string.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * Optional perceptual hash value, 16 hexadecimal characters. It must be computed as"Perceptual hashes" in the API description prescribes; a value from another procedureis stored but can never be matched.
      */
     pHash?: string | null;
 }
 export interface AddDownloadedFromIndexerRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The downloadIdentifier property
+     * Download identifier returned by the indexer or download client.
      */
     downloadIdentifier?: string | null;
     /**
-     * The filenames property
+     * Optional filename rows to create together with the parent entry.
      */
     filenames?: AddDownloadedFromIndexerFilenameRequest[] | null;
     /**
-     * The indexerId property
+     * Indexer-specific identifier for the download item.
      */
     indexerId?: string | null;
     /**
@@ -503,35 +521,41 @@ export interface AddDownloadedFromIndexerRequest extends AdditionalDataHolder, P
      */
     indexerSource?: number | null;
     /**
-     * The nzbName property
+     * NZB or release name.
      */
     nzbName?: string | null;
     /**
-     * The nzbUrl property
+     * NZB or release URL.
      */
     nzbUrl?: string | null;
     /**
-     * The videoId property
+     * Optional ID of the wanted video this download belongs to. Pass null when the download is not linked to a video yet.
      */
     videoId?: Guid | null;
 }
+/**
+ * Request body for batch-adding wanted videos.
+ */
 export interface AddWantedVideosBatchRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The videoIds property
+     * IDs of the videos to add. Between 1 and 50 entries.
      */
     videoIds?: Guid[] | null;
 }
+/**
+ * Summary of a batch add-wanted-videos operation.
+ */
 export interface AddWantedVideosBatchResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The added property
+     * Number of entries newly added to the wanted list.
      */
     added?: number | null;
     /**
-     * The alreadyExisted property
+     * Number of entries that were already on the wanted list.
      */
     alreadyExisted?: number | null;
     /**
-     * The notFound property
+     * Number of video IDs that were not found in the database.
      */
     notFound?: number | null;
 }
@@ -1891,59 +1915,65 @@ export declare function deserializeIntoWantedVideoChangeWantedVideoDto(wantedVid
  * @returns {Record<string, (node: ParseNode) => void>}
  */
 export declare function deserializeIntoWantedVideoSummaryDto(wantedVideoSummaryDto?: Partial<WantedVideoSummaryDto> | undefined): Record<string, (node: ParseNode) => void>;
+/**
+ * A filename recorded for a downloaded-from-indexer entry.
+ */
 export interface DownloadedFromIndexerFilenameDto extends AdditionalDataHolder, Parsable {
     /**
-     * The createdAtUtc property
+     * When this filename row was created.
      */
     createdAtUtc?: Date | null;
     /**
-     * The downloadedFromIndexerId property
+     * ID of the parent downloaded-from-indexer entry.
      */
     downloadedFromIndexerId?: Guid | null;
     /**
-     * The filename property
+     * The filename as reported by the indexer/download source.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * File size in bytes.
      */
     filesize?: number | null;
     /**
-     * The id property
+     * ID of the filename row.
      */
     id?: Guid | null;
     /**
-     * The osHash property
+     * Optional OS hash value as a 16-character fixed-length string.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * Optional perceptual hash value as a 16-character fixed-length string.
      */
     pHash?: string | null;
     /**
-     * The updatedAtUtc property
+     * When this filename row was last updated.
      */
     updatedAtUtc?: Date | null;
 }
+/**
+ * A downloaded-from-indexer entry for the current user.
+ */
 export interface DownloadedFromIndexerResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The createdAtUtc property
+     * When this entry was created.
      */
     createdAtUtc?: Date | null;
     /**
-     * The downloadIdentifier property
+     * Download identifier returned by the indexer or download client.
      */
     downloadIdentifier?: string | null;
     /**
-     * The filenames property
+     * Filename rows recorded for this entry.
      */
     filenames?: DownloadedFromIndexerFilenameDto[] | null;
     /**
-     * The id property
+     * ID of the downloaded-from-indexer entry.
      */
     id?: Guid | null;
     /**
-     * The indexerId property
+     * Indexer-specific identifier for the download item.
      */
     indexerId?: string | null;
     /**
@@ -1951,32 +1981,38 @@ export interface DownloadedFromIndexerResponse extends AdditionalDataHolder, Par
      */
     indexerSource?: number | null;
     /**
-     * The nzbName property
+     * NZB or release name.
      */
     nzbName?: string | null;
     /**
-     * The nzbUrl property
+     * NZB or release URL.
      */
     nzbUrl?: string | null;
     /**
-     * The updatedAtUtc property
+     * When this entry was last updated.
      */
     updatedAtUtc?: Date | null;
     /**
-     * The videoId property
+     * ID of the associated wanted video, or null when the download is not linked to a video.
      */
     videoId?: Guid | null;
 }
+/**
+ * A single changed favorite actor row in the incremental feed.
+ */
 export interface FavoriteActorChangeDto extends AdditionalDataHolder, Parsable {
     /**
-     * The eventType property
+     * One of `created`, `updated`, or `deleted`.
      */
     eventType?: string | null;
     /**
-     * The favoriteActor property
+     * Current-state payload for a favorite actor row in the incremental feed.
      */
     favoriteActor?: FavoriteActorChangeFavoriteActorDto | null;
 }
+/**
+ * Current-state payload for a favorite actor row in the incremental feed.
+ */
 export interface FavoriteActorChangeFavoriteActorDto extends AdditionalDataHolder, Parsable {
     /**
      * The deletedAtUtc property
@@ -2011,14 +2047,22 @@ export interface FavoriteActorChangeFavoriteActorDto extends AdditionalDataHolde
      */
     nationality?: string | null;
     /**
-     * The profileImageCdnPath property
+     * Deprecated alias for `profileImageUrl`, carrying the identical value. The nameclaimed a path fragment that was never sent; read `profileImageUrl` instead. Removed inthe next major version.
+     * @deprecated
      */
     profileImageCdnPath?: string | null;
+    /**
+     * Absolute URL of the actor's face/profile image, if available: a complete URL includingscheme and host, ready to request as-is.
+     */
+    profileImageUrl?: string | null;
     /**
      * The updatedAtUtc property
      */
     updatedAtUtc?: Date | null;
 }
+/**
+ * Seek cursor for continuing a favorite actor change feed.
+ */
 export interface FavoriteActorChangesCursorDto extends AdditionalDataHolder, Parsable {
     /**
      * The id property
@@ -2029,17 +2073,20 @@ export interface FavoriteActorChangesCursorDto extends AdditionalDataHolder, Par
      */
     updatedAtUtc?: Date | null;
 }
+/**
+ * Summary of an actor in the current user's favorites list.
+ */
 export interface FavoriteActorSummaryDto extends AdditionalDataHolder, Parsable {
     /**
-     * The ethnicity property
+     * Ethnicity label.
      */
     ethnicity?: string | null;
     /**
-     * The favoritedAtUtc property
+     * UTC timestamp when the user added this actor to their favorites.
      */
     favoritedAtUtc?: Date | null;
     /**
-     * The gender property
+     * Gender label (e.g. `Female`, `Male`, `Unknown`).
      */
     gender?: string | null;
     /**
@@ -2051,24 +2098,35 @@ export interface FavoriteActorSummaryDto extends AdditionalDataHolder, Parsable
      */
     name?: string | null;
     /**
-     * The nationality property
+     * Nationality label.
      */
     nationality?: string | null;
     /**
-     * The profileImageCdnPath property
+     * Deprecated alias for `profileImageUrl`, carrying the identical value. The nameclaimed a path fragment that was never sent; read `profileImageUrl` instead. Removed inthe next major version.
+     * @deprecated
      */
     profileImageCdnPath?: string | null;
+    /**
+     * Absolute URL of the actor's face/profile image, if available: a complete URL includingscheme and host, ready to request as-is.
+     */
+    profileImageUrl?: string | null;
 }
+/**
+ * A single changed favorite site row in the incremental feed.
+ */
 export interface FavoriteSiteChangeDto extends AdditionalDataHolder, Parsable {
     /**
-     * The eventType property
+     * One of `created`, `updated`, or `deleted`.
      */
     eventType?: string | null;
     /**
-     * The favoriteSite property
+     * Current-state payload for a favorite site row in the incremental feed.
      */
     favoriteSite?: FavoriteSiteChangeFavoriteSiteDto | null;
 }
+/**
+ * Current-state payload for a favorite site row in the incremental feed.
+ */
 export interface FavoriteSiteChangeFavoriteSiteDto extends AdditionalDataHolder, Parsable {
     /**
      * The deletedAtUtc property
@@ -2107,6 +2165,9 @@ export interface FavoriteSiteChangeFavoriteSiteDto extends AdditionalDataHolder,
      */
     url?: string | null;
 }
+/**
+ * Seek cursor for continuing a favorite site change feed.
+ */
 export interface FavoriteSiteChangesCursorDto extends AdditionalDataHolder, Parsable {
     /**
      * The id property
@@ -2117,9 +2178,12 @@ export interface FavoriteSiteChangesCursorDto extends AdditionalDataHolder, Pars
      */
     updatedAtUtc?: Date | null;
 }
+/**
+ * Summary of a site in the current user's favorites list.
+ */
 export interface FavoriteSiteSummaryDto extends AdditionalDataHolder, Parsable {
     /**
-     * The favoritedAtUtc property
+     * UTC timestamp when the user added this site to their favorites.
      */
     favoritedAtUtc?: Date | null;
     /**
@@ -2143,9 +2207,12 @@ export interface FavoriteSiteSummaryDto extends AdditionalDataHolder, Parsable {
      */
     url?: string | null;
 }
+/**
+ * A single fulfilment update.
+ */
 export interface FulfillWantedVideoItem extends AdditionalDataHolder, Parsable {
     /**
-     * The fulfilledAtUtc property
+     * When the video was fulfilled. Ignored when isFulfilled is false; defaults to the server time when omitted.
      */
     fulfilledAtUtc?: Date | null;
     /**
@@ -2157,40 +2224,52 @@ export interface FulfillWantedVideoItem extends AdditionalDataHolder, Parsable {
      */
     fulfillmentByApp?: number | null;
     /**
-     * The fulfillmentExternalId property
+     * External identifier from the fulfilling application, if applicable.
      */
     fulfillmentExternalId?: string | null;
     /**
-     * The isFulfilled property
+     * Whether the wanted video has been fulfilled.
      */
     isFulfilled?: boolean | null;
     /**
-     * The videoId property
+     * ID of the video whose wanted entry is updated. Must be unique within the request.
      */
     videoId?: Guid | null;
 }
+/**
+ * What happened to one video of the batch.
+ */
 export interface FulfillWantedVideoResultDto extends AdditionalDataHolder, Parsable {
     /**
-     * Known values: Updated (0), Unchanged (1), NotWanted (2), NotFound (3).
+     * Outcome of a single fulfilment update. Known values: Updated (0), Unchanged (1), NotWanted (2), NotFound (3).
      */
     outcome?: number | null;
     /**
-     * The videoId property
+     * ID of the video this result belongs to.
      */
     videoId?: Guid | null;
 }
+/**
+ * Request body for batch-updating the fulfilment state of wanted videos.
+ */
 export interface FulfillWantedVideosBatchRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * Fulfilment updates to apply. Between 1 and 50 entries, each for a distinct video.
      */
     items?: FulfillWantedVideoItem[] | null;
 }
+/**
+ * Per-video outcome of a batch fulfilment update.
+ */
 export interface FulfillWantedVideosBatchResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The results property
+     * One result per requested video, in request order.
      */
     results?: FulfillWantedVideoResultDto[] | null;
 }
+/**
+ * A seek-paged actor delta feed ordered by updated timestamp and actor ID.
+ */
 export interface GetActorChangesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The hasMore property
@@ -2201,7 +2280,7 @@ export interface GetActorChangesResponse extends AdditionalDataHolder, Parsable
      */
     items?: ActorChangeDto[] | null;
     /**
-     * The nextCursor property
+     * Seek cursor for continuing an actor change feed.
      */
     nextCursor?: ActorChangesCursorDto | null;
     /**
@@ -2209,7 +2288,7 @@ export interface GetActorChangesResponse extends AdditionalDataHolder, Parsable
      */
     pageSize?: number | null;
     /**
-     * The serverTimeUtc property
+     * The server's clock when this page was produced, read before the rows were queried.Safe to persist as the next `since` when `items` is empty: an empty pagecarries no row timestamp to continue from, and a client's own clock or the HTTP`Date` header are not sound substitutes for a value the server later reads backas a lower bound.
      */
     serverTimeUtc?: Date | null;
 }
@@ -2219,6 +2298,9 @@ export interface GetActorsByIdsRequest extends AdditionalDataHolder, Parsable {
      */
     ids?: Guid[] | null;
 }
+/**
+ * Paged delta feed of favorite actor changes ordered by updated timestamp and ID.
+ */
 export interface GetFavoriteActorChangesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The hasMore property
@@ -2229,7 +2311,7 @@ export interface GetFavoriteActorChangesResponse extends AdditionalDataHolder, P
      */
     items?: FavoriteActorChangeDto[] | null;
     /**
-     * The nextCursor property
+     * Seek cursor for continuing a favorite actor change feed.
      */
     nextCursor?: FavoriteActorChangesCursorDto | null;
     /**
@@ -2237,10 +2319,13 @@ export interface GetFavoriteActorChangesResponse extends AdditionalDataHolder, P
      */
     pageSize?: number | null;
     /**
-     * The serverTimeUtc property
+     * The server's clock when this page was produced, read before the rows were queried.Safe to persist as the next `since` when `items` is empty: an empty pagecarries no row timestamp to continue from, and a client's own clock or the HTTP`Date` header are not sound substitutes for a value the server later reads backas a lower bound.
      */
     serverTimeUtc?: Date | null;
 }
+/**
+ * Paged delta feed of favorite site changes ordered by updated timestamp and ID.
+ */
 export interface GetFavoriteSiteChangesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The hasMore property
@@ -2251,7 +2336,7 @@ export interface GetFavoriteSiteChangesResponse extends AdditionalDataHolder, Pa
      */
     items?: FavoriteSiteChangeDto[] | null;
     /**
-     * The nextCursor property
+     * Seek cursor for continuing a favorite site change feed.
      */
     nextCursor?: FavoriteSiteChangesCursorDto | null;
     /**
@@ -2259,23 +2344,29 @@ export interface GetFavoriteSiteChangesResponse extends AdditionalDataHolder, Pa
      */
     pageSize?: number | null;
     /**
-     * The serverTimeUtc property
+     * The server's clock when this page was produced, read before the rows were queried.Safe to persist as the next `since` when `items` is empty: an empty pagecarries no row timestamp to continue from, and a client's own clock or the HTTP`Date` header are not sound substitutes for a value the server later reads backas a lower bound.
      */
     serverTimeUtc?: Date | null;
 }
+/**
+ * Health check response.
+ */
 export interface GetHealthResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The status property
+     * Always "ok" when the API is reachable.
      */
     status?: string | null;
     /**
-     * The timestamp property
+     * UTC timestamp at the time of the request.
      */
     timestamp?: Date | null;
 }
+/**
+ * Paged delta feed of indexer filehash changes ordered by updated timestamp and ID.
+ */
 export interface GetIndexerFilehashChangesResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The hasMore property
+     * Whether additional rows exist after the current page.
      */
     hasMore?: boolean | null;
     /**
@@ -2283,35 +2374,41 @@ export interface GetIndexerFilehashChangesResponse extends AdditionalDataHolder,
      */
     items?: IndexerFilehashChangeDto[] | null;
     /**
-     * The nextCursor property
+     * Seek cursor for continuing an indexer filehash change feed.
      */
     nextCursor?: IndexerFilehashChangesCursorDto | null;
     /**
-     * The pageSize property
+     * The resolved page size for this response.
      */
     pageSize?: number | null;
     /**
-     * The serverTimeUtc property
+     * The server's clock when this page was produced, read before the rows were queried.Safe to persist as the next `since` when `items` is empty: an empty pagecarries no row timestamp to continue from, and a client's own clock or the HTTP`Date` header are not sound substitutes for a value the server later reads backas a lower bound.
      */
     serverTimeUtc?: Date | null;
 }
+/**
+ * Current rate limit status for the authenticated user.
+ */
 export interface GetRateLimitResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The hourly property
+     * Rate limit status for a single time window.
      */
     hourly?: RateLimitWindowStatus | null;
     /**
-     * The isEnforced property
+     * Always true. Rate limiting is enforced unconditionally; when it cannot be enforced the APIanswers 503 instead of returning this document. Kept for compatibility with clients thatread the field.
      */
     isEnforced?: boolean | null;
     /**
-     * The monthly property
+     * Rate limit status for a single time window.
      */
     monthly?: RateLimitWindowStatus | null;
 }
+/**
+ * Paged delta feed of video filehash changes ordered by updated timestamp and ID.
+ */
 export interface GetVideoFilehashChangesResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The hasMore property
+     * Whether additional rows exist after the current page.
      */
     hasMore?: boolean | null;
     /**
@@ -2319,15 +2416,15 @@ export interface GetVideoFilehashChangesResponse extends AdditionalDataHolder, P
      */
     items?: VideoFilehashChangeDto[] | null;
     /**
-     * The nextCursor property
+     * Seek cursor for continuing a video filehash change feed.
      */
     nextCursor?: VideoFilehashChangesCursorDto | null;
     /**
-     * The pageSize property
+     * The resolved page size for this response.
      */
     pageSize?: number | null;
     /**
-     * The serverTimeUtc property
+     * The server's clock when this page was produced, read before the rows were queried.Safe to persist as the next `since` when `items` is empty: an empty pagecarries no row timestamp to continue from, and a client's own clock or the HTTP`Date` header are not sound substitutes for a value the server later reads backas a lower bound.
      */
     serverTimeUtc?: Date | null;
 }
@@ -2371,10 +2468,13 @@ export interface GetVideoUserImageChangesResponse extends AdditionalDataHolder,
      */
     pageSize?: number | null;
     /**
-     * The serverTimeUtc property
+     * The server's clock when this page was produced, read before the rows were queried.Safe to persist as the next `since` when `items` is empty: an empty pagecarries no row timestamp to continue from, and a client's own clock or the HTTP`Date` header are not sound substitutes for a value the server later reads backas a lower bound.
      */
     serverTimeUtc?: Date | null;
 }
+/**
+ * Paged delta feed of wanted video changes ordered by updated timestamp and ID.
+ */
 export interface GetWantedVideoChangesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The hasMore property
@@ -2385,7 +2485,7 @@ export interface GetWantedVideoChangesResponse extends AdditionalDataHolder, Par
      */
     items?: WantedVideoChangeDto[] | null;
     /**
-     * The nextCursor property
+     * Seek cursor for continuing a wanted video change feed.
      */
     nextCursor?: WantedVideoChangesCursorDto | null;
     /**
@@ -2393,53 +2493,62 @@ export interface GetWantedVideoChangesResponse extends AdditionalDataHolder, Par
      */
     pageSize?: number | null;
     /**
-     * The serverTimeUtc property
+     * The server's clock when this page was produced, read before the rows were queried.Safe to persist as the next `since` when `items` is empty: an empty pagecarries no row timestamp to continue from, and a client's own clock or the HTTP`Date` header are not sound substitutes for a value the server later reads backas a lower bound.
      */
     serverTimeUtc?: Date | null;
 }
+/**
+ * The site a file could be attributed to.
+ */
 export interface IdentifySiteDto extends AdditionalDataHolder, Parsable {
     /**
-     * The id property
+     * Unique identifier of the site.
      */
     id?: Guid | null;
     /**
-     * The title property
+     * Site title.
      */
     title?: string | null;
     /**
-     * The url property
+     * Site URL.
      */
     url?: string | null;
 }
+/**
+ * One file to identify.
+ */
 export interface IdentifyVideoFileDto extends AdditionalDataHolder, Parsable {
     /**
-     * The filename property
+     * File name without directory. Required — it carries the lowest rungs of the ladder.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * Size of the file in bytes, if known.
      */
     filesize?: number | null;
     /**
-     * The osHash property
+     * OS hash of the file, 16 hexadecimal characters, if the client computed one.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * Perceptual hash of the file, 16 hexadecimal characters, if the client computed one.Compared for equality only, and only against values computed the way "Perceptual hashes"in the API description prescribes — send none rather than one from another procedure.
      */
     pHash?: string | null;
     /**
-     * The ref property
+     * Client-assigned identifier, returned unchanged. Unique within the request.
      */
     ref?: string | null;
 }
+/**
+ * What the identification ladder made of one file.
+ */
 export interface IdentifyVideoResultDto extends AdditionalDataHolder, Parsable {
     /**
-     * The candidates property
+     * All equally good videos when the match was ambiguous; otherwise empty.
      */
     candidates?: Guid[] | null;
     /**
-     * Known values: None (0), Partial (1), Probable (2), Strong (3), Exact (4), Ambiguous (5).
+     * How much the match can be trusted. Drives whether a client files a file automatically. Known values: None (0), Partial (1), Probable (2), Strong (3), Exact (4), Ambiguous (5).
      */
     confidence?: number | null;
     /**
@@ -2447,11 +2556,11 @@ export interface IdentifyVideoResultDto extends AdditionalDataHolder, Parsable {
      */
     matchedBy?: number | null;
     /**
-     * The ref property
+     * The client-assigned identifier of the input file, returned unchanged.
      */
     ref?: string | null;
     /**
-     * The site property
+     * The site a file could be attributed to.
      */
     site?: IdentifySiteDto | null;
     /**
@@ -2459,51 +2568,63 @@ export interface IdentifyVideoResultDto extends AdditionalDataHolder, Parsable {
      */
     video?: VideoDetailDto | null;
     /**
-     * The videoId property
+     * The identified video, when exactly one was found.
      */
     videoId?: Guid | null;
 }
+/**
+ * Request body for identifying local files against the prdb catalogue.
+ */
 export interface IdentifyVideosRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The files property
+     * Files to identify. Between 1 and 200 entries.
      */
     files?: IdentifyVideoFileDto[] | null;
     /**
-     * The includeVideoDetails property
+     * When true, each matched result carries the full video document. Defaults to false.
      */
     includeVideoDetails?: boolean | null;
 }
+/**
+ * Identification results, one per submitted file.
+ */
 export interface IdentifyVideosResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The results property
+     * One result per input file, in input order.
      */
     results?: IdentifyVideoResultDto[] | null;
 }
+/**
+ * A single changed indexer filehash row in the incremental feed.
+ */
 export interface IndexerFilehashChangeDto extends AdditionalDataHolder, Parsable {
     /**
-     * The eventType property
+     * One of `created`, `updated`, or `deleted`.
      */
     eventType?: string | null;
     /**
-     * The filehash property
+     * Current persisted state of a changed indexer filehash row, including soft-delete fields.
      */
     filehash?: IndexerFilehashChangeFilehashDto | null;
 }
+/**
+ * Current persisted state of a changed indexer filehash row, including soft-delete fields.
+ */
 export interface IndexerFilehashChangeFilehashDto extends AdditionalDataHolder, Parsable {
     /**
      * The createdAtUtc property
      */
     createdAtUtc?: Date | null;
     /**
-     * The deletedAtUtc property
+     * Timestamp when the row was soft-deleted, or null when still active.
      */
     deletedAtUtc?: Date | null;
     /**
-     * The filename property
+     * Original filename submitted for this filehash record.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * File size in bytes.
      */
     filesize?: number | null;
     /**
@@ -2511,31 +2632,31 @@ export interface IndexerFilehashChangeFilehashDto extends AdditionalDataHolder,
      */
     id?: Guid | null;
     /**
-     * The indexerId property
+     * Indexer-specific identifier for the release.
      */
     indexerId?: string | null;
     /**
-     * The indexerSource property
+     * Indexer source. Supported values: `DrunkenSlug`, `NzbFinder`, `NzbPorn`.
      */
     indexerSource?: string | null;
     /**
-     * The isDeleted property
+     * Whether this row is soft-deleted.
      */
     isDeleted?: boolean | null;
     /**
-     * The isVerified property
+     * Whether this filehash record has been verified.
      */
     isVerified?: boolean | null;
     /**
-     * The osHash property
+     * OS hash value as stored.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * P hash value as stored, or null when not available.
      */
     pHash?: string | null;
     /**
-     * The submissionCount property
+     * Number of submissions merged into this filehash record.
      */
     submissionCount?: number | null;
     /**
@@ -2543,6 +2664,9 @@ export interface IndexerFilehashChangeFilehashDto extends AdditionalDataHolder,
      */
     updatedAtUtc?: Date | null;
 }
+/**
+ * Seek cursor for continuing an indexer filehash change feed.
+ */
 export interface IndexerFilehashChangesCursorDto extends AdditionalDataHolder, Parsable {
     /**
      * The id property
@@ -2559,11 +2683,11 @@ export interface IndexerFilehashDto extends AdditionalDataHolder, Parsable {
      */
     createdAtUtc?: Date | null;
     /**
-     * The filename property
+     * Original filename submitted for this filehash record.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * File size in bytes.
      */
     filesize?: number | null;
     /**
@@ -2571,27 +2695,27 @@ export interface IndexerFilehashDto extends AdditionalDataHolder, Parsable {
      */
     id?: Guid | null;
     /**
-     * The indexerId property
+     * Indexer-specific identifier for the release.
      */
     indexerId?: string | null;
     /**
-     * The indexerSource property
+     * Indexer source. Supported values: `DrunkenSlug`, `NzbFinder`, `NzbPorn`.
      */
     indexerSource?: string | null;
     /**
-     * The isVerified property
+     * Whether this filehash record has been verified.
      */
     isVerified?: boolean | null;
     /**
-     * The osHash property
+     * OS hash value as stored.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * P hash value as stored, or null when not available.
      */
     pHash?: string | null;
     /**
-     * The submissionCount property
+     * Number of submissions merged into this filehash record.
      */
     submissionCount?: number | null;
     /**
@@ -2599,40 +2723,46 @@ export interface IndexerFilehashDto extends AdditionalDataHolder, Parsable {
      */
     updatedAtUtc?: Date | null;
 }
+/**
+ * Combined indexer identity used to match filehashes by indexer source and indexer-specific ID.
+ */
 export interface IndexerFilehashLookupKeyDto extends AdditionalDataHolder, Parsable {
     /**
-     * The indexerId property
+     * Indexer-specific identifier for the release.
      */
     indexerId?: string | null;
     /**
-     * Allowed values: DrunkenSlug, NzbFinder, NzbPorn.
+     * Indexer source. Supported values: `DrunkenSlug`, `NzbFinder`, `NzbPorn`. Allowed values: DrunkenSlug, NzbFinder, NzbPorn.
      */
     indexerSource?: IndexerFilehashLookupKeyDto_indexerSource | null;
 }
 export type IndexerFilehashLookupKeyDto_indexerSource = (typeof IndexerFilehashLookupKeyDto_indexerSourceObject)[keyof typeof IndexerFilehashLookupKeyDto_indexerSourceObject];
+/**
+ * Paged list of the latest indexer filehash entries.
+ */
 export interface LatestIndexerFilehashesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The items property
      */
     items?: IndexerFilehashDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Resolved sort field for the current query.
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Resolved sort direction for the current query.
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of filehash entries matching the current filters.
      */
     totalCount?: number | null;
 }
@@ -2654,21 +2784,24 @@ export interface LatestPreDbItemDto extends AdditionalDataHolder, Parsable {
      */
     video?: LatestPreDbVideoDto | null;
 }
+/**
+ * Paged list of the latest PreDb entries.
+ */
 export interface LatestPreDbResponse extends AdditionalDataHolder, Parsable {
     /**
      * The items property
      */
     items?: LatestPreDbItemDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The totalCount property
+     * Total number of PreDb entries matching the current filters.
      */
     totalCount?: number | null;
 }
@@ -2700,256 +2833,283 @@ export interface LatestPreDbVideoDto extends AdditionalDataHolder, Parsable {
      */
     title?: string | null;
 }
+/**
+ * Paged list of the latest video filehash entries.
+ */
 export interface LatestVideoFilehashesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The items property
      */
     items?: VideoFilehashDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Resolved sort field for the current query.
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Resolved sort direction for the current query.
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of filehash entries matching the current filters.
      */
     totalCount?: number | null;
 }
+/**
+ * Paged list of actors.
+ */
 export interface ListActorsResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * Actors on the current page.
      */
     items?: ActorSummaryDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Field the result is sorted by: "name" or "createdAtUtc".
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Sort direction applied: "asc" or "desc".
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of actors matching the current query filters.
      */
     totalCount?: number | null;
     /**
-     * The totalPages property
+     * Total number of pages for the current query and page size.
      */
     totalPages?: number | null;
 }
+/**
+ * Paged list of the current user's favorite actors.
+ */
 export interface ListFavoriteActorsResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * Favorite actor entries on the current page.
      */
     items?: FavoriteActorSummaryDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Field the results are sorted by.
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Sort direction applied: `asc` or `desc`.
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of favorite actors matching the current query filters.
      */
     totalCount?: number | null;
     /**
-     * The totalPages property
+     * Total number of pages.
      */
     totalPages?: number | null;
 }
+/**
+ * Paged list of the current user's favorite sites.
+ */
 export interface ListFavoriteSitesResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * Favorite site entries on the current page.
      */
     items?: FavoriteSiteSummaryDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Field the results are sorted by.
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Sort direction applied: `asc` or `desc`.
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of favorite sites matching the current query filters.
      */
     totalCount?: number | null;
     /**
-     * The totalPages property
+     * Total number of pages.
      */
     totalPages?: number | null;
 }
+/**
+ * Paged list of PreDb entries.
+ */
 export interface ListPreDbResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * PreDb entries on the current page.
      */
     items?: PreDbSummaryDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Field the result is sorted by: "releaseDate" or "title".
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Sort direction applied: "asc" or "desc".
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of entries matching the current query filters.
      */
     totalCount?: number | null;
 }
+/**
+ * Paged list of sites.
+ */
 export interface ListSitesResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * Sites on the current page.
      */
     items?: SiteSummaryDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Field the result is sorted by: "title".
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Sort direction applied: "asc" or "desc".
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of sites matching the current query filters.
      */
     totalCount?: number | null;
 }
+/**
+ * Paged list of videos.
+ */
 export interface ListVideosResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * Videos on the current page.
      */
     items?: VideoSummaryDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Field the result is sorted by: "title" or "releaseDate".
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Sort direction applied: "asc" or "desc".
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of videos matching the current query filters.
      */
     totalCount?: number | null;
 }
+/**
+ * Paged list of the current user's wanted videos.
+ */
 export interface ListWantedVideosResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * Wanted video entries on the current page.
      */
     items?: WantedVideoSummaryDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Field the results are sorted by.
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Sort direction applied: `asc` or `desc`.
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of wanted videos matching the current query filters.
      */
     totalCount?: number | null;
     /**
-     * The totalPages property
+     * Total number of pages.
      */
     totalPages?: number | null;
 }
 export interface LookupIndexerFilehashesRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The filenames property
+     * Optional exact filenames to match.
      */
     filenames?: string[] | null;
     /**
-     * The filesizes property
+     * Optional exact file sizes to match.
      */
     filesizes?: number[] | null;
     /**
-     * The ids property
+     * Optional filehash row IDs to match.
      */
     ids?: Guid[] | null;
     /**
-     * The indexerKeys property
+     * Optional combined indexer source and indexer ID pairs to match.
      */
     indexerKeys?: IndexerFilehashLookupKeyDto[] | null;
     /**
-     * The osHashes property
+     * Optional OS hash values to match.
      */
     osHashes?: string[] | null;
     /**
-     * The pHashes property
+     * Optional perceptual hash values to match, 16 hexadecimal characters each. Matched forequality, so a value computed by any procedure other than the one under "Perceptualhashes" in the API description matches nothing rather than failing.
      */
     pHashes?: string[] | null;
 }
+/**
+ * Flat indexer filehash lookup results.
+ */
 export interface LookupIndexerFilehashesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The items property
@@ -2958,30 +3118,33 @@ export interface LookupIndexerFilehashesResponse extends AdditionalDataHolder, P
 }
 export interface LookupVideoFilehashesRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The filenames property
+     * Optional exact filenames to match.
      */
     filenames?: string[] | null;
     /**
-     * The filesizes property
+     * Optional exact file sizes to match.
      */
     filesizes?: number[] | null;
     /**
-     * The ids property
+     * Optional filehash row IDs to match.
      */
     ids?: Guid[] | null;
     /**
-     * The osHashes property
+     * Optional OS hash values to match.
      */
     osHashes?: string[] | null;
     /**
-     * The pHashes property
+     * Optional perceptual hash values to match, 16 hexadecimal characters each. Matched forequality, so a value computed by any procedure other than the one under "Perceptualhashes" in the API description matches nothing rather than failing.
      */
     pHashes?: string[] | null;
     /**
-     * The videoIds property
+     * Optional associated video IDs to match.
      */
     videoIds?: Guid[] | null;
 }
+/**
+ * Flat filehash lookup results.
+ */
 export interface LookupVideoFilehashesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The items property
@@ -2998,29 +3161,32 @@ export interface PreDbItemDto extends AdditionalDataHolder, Parsable {
      */
     title?: string | null;
 }
+/**
+ * Summary representation of a PreDb entry.
+ */
 export interface PreDbSummaryDto extends AdditionalDataHolder, Parsable {
     /**
-     * The category property
+     * Readable category value: Movies, TvShows, or Adult.
      */
     category?: string | null;
     /**
-     * The filesize property
+     * Optional file size value if known.
      */
     filesize?: number | null;
     /**
-     * The id property
+     * Unique identifier of the PreDb entry.
      */
     id?: Guid | null;
     /**
-     * The releaseDate property
+     * Release date associated with the entry.
      */
     releaseDate?: DateOnly | null;
     /**
-     * The releaseGroup property
+     * Release group name.
      */
     releaseGroup?: string | null;
     /**
-     * The title property
+     * Release title as indexed in PreDb.
      */
     title?: string | null;
 }
@@ -3068,21 +3234,24 @@ export interface ProblemDetails extends AdditionalDataHolder, ApiError, Parsable
      */
     type?: string | null;
 }
+/**
+ * Rate limit status for a single time window.
+ */
 export interface RateLimitWindowStatus extends AdditionalDataHolder, Parsable {
     /**
-     * The limit property
+     * Maximum number of requests allowed within this window.
      */
     limit?: number | null;
     /**
-     * The remaining property
+     * Number of requests remaining before the limit is reached.
      */
     remaining?: number | null;
     /**
-     * The resetsInSeconds property
+     * Seconds until the oldest request in the window expires, reducing the used count by one.
      */
     resetsInSeconds?: number | null;
     /**
-     * The used property
+     * Number of requests made within the current window.
      */
     used?: number | null;
 }
@@ -3121,7 +3290,7 @@ export interface SearchPreDbByVideoResponse extends AdditionalDataHolder, Parsab
      */
     items?: PreDbVideoGroupDto[] | null;
     /**
-     * The totalGroups property
+     * Number of distinct videos in the result set (capped at 500).
      */
     totalGroups?: number | null;
 }
@@ -3916,63 +4085,75 @@ export declare function serializeWantedVideoChangeWantedVideoDto(writer: Seriali
  * @param writer Serialization writer to use to serialize this model
  */
 export declare function serializeWantedVideoSummaryDto(writer: SerializationWriter, wantedVideoSummaryDto?: Partial<WantedVideoSummaryDto> | undefined | null, isSerializingDerivedType?: boolean): void;
+/**
+ * Summary of a single site.
+ */
 export interface SiteSummaryDto extends AdditionalDataHolder, Parsable {
     /**
-     * The createdAtUtc property
+     * When this site was created.
      */
     createdAtUtc?: Date | null;
     /**
-     * The id property
+     * Unique identifier of the site.
      */
     id?: Guid | null;
     /**
-     * The networkId property
+     * Unique identifier of the network this site belongs to, if any.
      */
     networkId?: Guid | null;
     /**
-     * The networkTitle property
+     * Title of the network this site belongs to, if any.
      */
     networkTitle?: string | null;
     /**
-     * The title property
+     * Site title.
      */
     title?: string | null;
     /**
-     * The updatedAtUtc property
+     * When this site was last changed.
      */
     updatedAtUtc?: Date | null;
     /**
-     * The url property
+     * Site URL.
      */
     url?: string | null;
 }
+/**
+ * Request body for submitting confirmed hash-to-video assignments.
+ */
 export interface SubmitVideoFilehashesRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The items property
+     * Assignments to submit. Between 1 and 200 entries.
      */
     items?: SubmitVideoFilehashItem[] | null;
 }
+/**
+ * Per-entry outcome of a filehash submission.
+ */
 export interface SubmitVideoFilehashesResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The results property
+     * One result per submitted entry, in request order.
      */
     results?: SubmitVideoFilehashResultDto[] | null;
 }
+/**
+ * A single hash-to-video assignment.
+ */
 export interface SubmitVideoFilehashItem extends AdditionalDataHolder, Parsable {
     /**
-     * The filename property
+     * File name without directory. Optional — a client may withhold it, and the endpoint works without it.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * Size of the file in bytes.
      */
     filesize?: number | null;
     /**
-     * The osHash property
+     * OS hash of the file, 16 hexadecimal characters. Required; it is the only aggregation key.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * Perceptual hash of the file, 16 hexadecimal characters, if the client computed one. It mustbe computed as "Perceptual hashes" in the API description prescribes; a submission carryinga value from another procedure contributes a row nothing can match.
      */
     pHash?: string | null;
     /**
@@ -3980,21 +4161,24 @@ export interface SubmitVideoFilehashItem extends AdditionalDataHolder, Parsable
      */
     source?: number | null;
     /**
-     * The videoId property
+     * The video this file is. Required — a hash observation without an assignment is not accepted.
      */
     videoId?: Guid | null;
 }
+/**
+ * What happened to one submitted assignment.
+ */
 export interface SubmitVideoFilehashResultDto extends AdditionalDataHolder, Parsable {
     /**
-     * The osHash property
+     * The OS hash of the entry, normalized to upper case.
      */
     osHash?: string | null;
     /**
-     * Known values: Recorded (0), Updated (1), Conflicted (2), VideoNotFound (3).
+     * Outcome of a single submission. Known values: Recorded (0), Updated (1), Conflicted (2), VideoNotFound (3).
      */
     outcome?: number | null;
     /**
-     * The videoId property
+     * The video the entry named.
      */
     videoId?: Guid | null;
 }
@@ -4016,57 +4200,60 @@ export interface SubmitVideoUserImageResponse extends AdditionalDataHolder, Pars
      */
     videoUserImageId?: Guid | null;
 }
+/**
+ * Paged list of active filehash entries that are not linked to a video.
+ */
 export interface UnlinkedVideoFilehashesResponse extends AdditionalDataHolder, Parsable {
     /**
      * The items property
      */
     items?: VideoFilehashDto[] | null;
     /**
-     * The page property
+     * Current page number (1-based).
      */
     page?: number | null;
     /**
-     * The pageSize property
+     * Number of items per page.
      */
     pageSize?: number | null;
     /**
-     * The sortBy property
+     * Resolved sort field for the current query.
      */
     sortBy?: string | null;
     /**
-     * The sortDirection property
+     * Resolved sort direction for the current query.
      */
     sortDirection?: string | null;
     /**
-     * The totalCount property
+     * Total number of active unlinked filehash entries matching the current filters.
      */
     totalCount?: number | null;
 }
 export interface UpdateDownloadedFromIndexerFilenameRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The filename property
+     * The filename as reported by the indexer/download source.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * File size in bytes.
      */
     filesize?: number | null;
     /**
-     * The osHash property
+     * Optional OS hash value as a 16-character fixed-length string.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * Optional perceptual hash value, 16 hexadecimal characters. It must be computed as"Perceptual hashes" in the API description prescribes; a value from another procedureis stored but can never be matched.
      */
     pHash?: string | null;
 }
 export interface UpdateDownloadedFromIndexerRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The downloadIdentifier property
+     * Download identifier returned by the indexer or download client.
      */
     downloadIdentifier?: string | null;
     /**
-     * The indexerId property
+     * Indexer-specific identifier for the download item.
      */
     indexerId?: string | null;
     /**
@@ -4074,17 +4261,17 @@ export interface UpdateDownloadedFromIndexerRequest extends AdditionalDataHolder
      */
     indexerSource?: number | null;
     /**
-     * The nzbName property
+     * NZB or release name.
      */
     nzbName?: string | null;
     /**
-     * The nzbUrl property
+     * NZB or release URL.
      */
     nzbUrl?: string | null;
 }
 export interface UpdateWantedVideoRequest extends AdditionalDataHolder, Parsable {
     /**
-     * The fulfilledAtUtc property
+     * When the wanted video was fulfilled, if applicable.
      */
     fulfilledAtUtc?: Date | null;
     /**
@@ -4096,21 +4283,24 @@ export interface UpdateWantedVideoRequest extends AdditionalDataHolder, Parsable
      */
     fulfillmentByApp?: number | null;
     /**
-     * The fulfillmentExternalId property
+     * External identifier from the fulfilling application, if applicable.
      */
     fulfillmentExternalId?: string | null;
     /**
-     * The isFulfilled property
+     * Whether the wanted video has been fulfilled.
      */
     isFulfilled?: boolean | null;
 }
+/**
+ * The updated wanted video entry.
+ */
 export interface UpdateWantedVideoResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The createdAtUtc property
+     * When this wanted video entry was created.
      */
     createdAtUtc?: Date | null;
     /**
-     * The fulfilledAtUtc property
+     * When the wanted video was fulfilled, if applicable.
      */
     fulfilledAtUtc?: Date | null;
     /**
@@ -4122,29 +4312,32 @@ export interface UpdateWantedVideoResponse extends AdditionalDataHolder, Parsabl
      */
     fulfillmentByApp?: number | null;
     /**
-     * The fulfillmentExternalId property
+     * External identifier from the fulfilling application, if applicable.
      */
     fulfillmentExternalId?: string | null;
     /**
-     * The isFulfilled property
+     * Whether this wanted video has been fulfilled.
      */
     isFulfilled?: boolean | null;
     /**
-     * The updatedAtUtc property
+     * When this wanted video entry was last updated.
      */
     updatedAtUtc?: Date | null;
     /**
-     * The videoId property
+     * ID of the video.
      */
     videoId?: Guid | null;
 }
+/**
+ * Identity and subscription state for the authenticated user.
+ */
 export interface UserIdentityResponse extends AdditionalDataHolder, Parsable {
     /**
-     * The activeSubscriptions property
+     * All subscriptions with Status=Active and an end date in the future.
      */
     activeSubscriptions?: ActiveSubscriptionDto[] | null;
     /**
-     * The userHash property
+     * Stable HMAC-SHA256 hex digest derived from the user's immutable ID.Suitable as a durable public identifier — does not change unless the server secret rotates.
      */
     userHash?: string | null;
 }
@@ -4162,7 +4355,7 @@ export interface VideoDetailActorDto extends AdditionalDataHolder, Parsable {
      */
     id?: Guid | null;
     /**
-     * The images property
+     * Images for this actor, ordered by ActorImageType VideoDetailActorImageDto.ImageType ascending(Thumbnail, Poster, Face), then oldest first, with the image ID as the tie-breaker. The orderis stable across requests.
      */
     images?: VideoDetailActorImageDto[] | null;
     /**
@@ -4176,7 +4369,8 @@ export interface VideoDetailActorDto extends AdditionalDataHolder, Parsable {
 }
 export interface VideoDetailActorImageDto extends AdditionalDataHolder, Parsable {
     /**
-     * The cdnPath property
+     * Deprecated alias for `url`, carrying the identical value. The name claimed a pathfragment that was never sent; read `url` instead. Removed in the next major version.
+     * @deprecated
      */
     cdnPath?: string | null;
     /**
@@ -4187,6 +4381,10 @@ export interface VideoDetailActorImageDto extends AdditionalDataHolder, Parsable
      * Known values: Thumbnail (1), Poster (2), Face (3).
      */
     imageType?: number | null;
+    /**
+     * Absolute URL for the image, if available: a complete URL including scheme and host, ready torequest as-is. The actor endpoints expose the same image under the same name.
+     */
+    url?: string | null;
 }
 export interface VideoDetailDto extends AdditionalDataHolder, Parsable {
     /**
@@ -4202,7 +4400,7 @@ export interface VideoDetailDto extends AdditionalDataHolder, Parsable {
      */
     id?: Guid | null;
     /**
-     * The images property
+     * Images for this video, ordered oldest first by the time they were added, with the image IDas the tie-breaker. The order is stable across requests.
      */
     images?: VideoDetailImageDto[] | null;
     /**
@@ -4228,13 +4426,18 @@ export interface VideoDetailDto extends AdditionalDataHolder, Parsable {
 }
 export interface VideoDetailImageDto extends AdditionalDataHolder, Parsable {
     /**
-     * The cdnPath property
+     * Deprecated alias for `url`, carrying the identical value. The name claimed a pathfragment that was never sent; read `url` instead. Removed in the next major version.
+     * @deprecated
      */
     cdnPath?: string | null;
     /**
      * The id property
      */
     id?: Guid | null;
+    /**
+     * Absolute URL for the image, if available: a complete URL including scheme and host, ready torequest as-is. This is the same value the deprecated `cdnPath` carries.
+     */
+    url?: string | null;
 }
 export interface VideoDetailNetworkDto extends AdditionalDataHolder, Parsable {
     /**
@@ -4278,31 +4481,37 @@ export interface VideoDetailSiteDto extends AdditionalDataHolder, Parsable {
      */
     url?: string | null;
 }
+/**
+ * A single changed video filehash row in the incremental feed.
+ */
 export interface VideoFilehashChangeDto extends AdditionalDataHolder, Parsable {
     /**
-     * The eventType property
+     * One of `created`, `updated`, or `deleted`.
      */
     eventType?: string | null;
     /**
-     * The filehash property
+     * Current persisted state of a changed video filehash row, including soft-delete fields.
      */
     filehash?: VideoFilehashChangeFilehashDto | null;
 }
+/**
+ * Current persisted state of a changed video filehash row, including soft-delete fields.
+ */
 export interface VideoFilehashChangeFilehashDto extends AdditionalDataHolder, Parsable {
     /**
      * The createdAtUtc property
      */
     createdAtUtc?: Date | null;
     /**
-     * The deletedAtUtc property
+     * Timestamp when the row was soft-deleted, or null when still active.
      */
     deletedAtUtc?: Date | null;
     /**
-     * The filename property
+     * Original filename submitted for this filehash record.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * File size in bytes.
      */
     filesize?: number | null;
     /**
@@ -4310,23 +4519,23 @@ export interface VideoFilehashChangeFilehashDto extends AdditionalDataHolder, Pa
      */
     id?: Guid | null;
     /**
-     * The isDeleted property
+     * Whether this row is soft-deleted.
      */
     isDeleted?: boolean | null;
     /**
-     * The isVerified property
+     * Whether this filehash record has been verified.
      */
     isVerified?: boolean | null;
     /**
-     * The osHash property
+     * OS hash value as stored, or null when not available.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * P hash value as stored, or null when not available.
      */
     pHash?: string | null;
     /**
-     * The submissionCount property
+     * Number of submissions merged into this filehash record.
      */
     submissionCount?: number | null;
     /**
@@ -4338,6 +4547,9 @@ export interface VideoFilehashChangeFilehashDto extends AdditionalDataHolder, Pa
      */
     videoId?: Guid | null;
 }
+/**
+ * Seek cursor for continuing a video filehash change feed.
+ */
 export interface VideoFilehashChangesCursorDto extends AdditionalDataHolder, Parsable {
     /**
      * The id property
@@ -4354,11 +4566,11 @@ export interface VideoFilehashDto extends AdditionalDataHolder, Parsable {
      */
     createdAtUtc?: Date | null;
     /**
-     * The filename property
+     * Original filename submitted for this filehash record.
      */
     filename?: string | null;
     /**
-     * The filesize property
+     * File size in bytes.
      */
     filesize?: number | null;
     /**
@@ -4366,19 +4578,19 @@ export interface VideoFilehashDto extends AdditionalDataHolder, Parsable {
      */
     id?: Guid | null;
     /**
-     * The isVerified property
+     * Whether this filehash record has been verified.
      */
     isVerified?: boolean | null;
     /**
-     * The osHash property
+     * OS hash value as stored, or null when not available.
      */
     osHash?: string | null;
     /**
-     * The pHash property
+     * P hash value as stored, or null when not available.
      */
     pHash?: string | null;
     /**
-     * The submissionCount property
+     * Number of submissions merged into this filehash record.
      */
     submissionCount?: number | null;
     /**
@@ -4400,43 +4612,49 @@ export interface VideoFilehashesByVideoIdDto extends AdditionalDataHolder, Parsa
      */
     videoId?: Guid | null;
 }
+/**
+ * Minimal actor summary included in a video list item.
+ */
 export interface VideoSummaryActorDto extends AdditionalDataHolder, Parsable {
     /**
-     * The id property
+     * Unique identifier of the actor.
      */
     id?: Guid | null;
     /**
-     * The name property
+     * Actor name.
      */
     name?: string | null;
 }
+/**
+ * Summary of a single video.
+ */
 export interface VideoSummaryDto extends AdditionalDataHolder, Parsable {
     /**
-     * The actors property
+     * Actors appearing in this video.
      */
     actors?: VideoSummaryActorDto[] | null;
     /**
-     * The createdAtUtc property
+     * Timestamp when the video was created in PRDB.
      */
     createdAtUtc?: Date | null;
     /**
-     * The id property
+     * Unique identifier of the video.
      */
     id?: Guid | null;
     /**
-     * The releaseDate property
+     * Release date of the video, if known.
      */
     releaseDate?: DateOnly | null;
     /**
-     * The siteId property
+     * Unique identifier of the site this video belongs to.
      */
     siteId?: Guid | null;
     /**
-     * The siteTitle property
+     * Title of the site this video belongs to.
      */
     siteTitle?: string | null;
     /**
-     * The title property
+     * Video title.
      */
     title?: string | null;
 }
@@ -4462,7 +4680,7 @@ export interface VideoUserImageChangesCursorDto extends AdditionalDataHolder, Pa
 }
 export interface VideoUserImageDto extends AdditionalDataHolder, Parsable {
     /**
-     * The basedOnFileWithOsHash property
+     * Server-validated 16-character OS hash of the file the preview is based on.
      */
     basedOnFileWithOsHash?: string | null;
     /**
@@ -4510,23 +4728,23 @@ export interface VideoUserImageDto extends AdditionalDataHolder, Parsable {
      */
     previewImageType?: string | null;
     /**
-     * The spriteColumns property
+     * Number of occupied tile columns in the sprite-sheet grid.
      */
     spriteColumns?: number | null;
     /**
-     * The spriteRows property
+     * Number of occupied tile rows in the sprite-sheet grid.
      */
     spriteRows?: number | null;
     /**
-     * The spriteTileCount property
+     * Number of sprite tiles described by the paired WebVTT metadata object.
      */
     spriteTileCount?: number | null;
     /**
-     * The spriteTileHeight property
+     * Uniform sprite tile height in pixels.
      */
     spriteTileHeight?: number | null;
     /**
-     * The spriteTileWidth property
+     * Uniform sprite tile width in pixels.
      */
     spriteTileWidth?: number | null;
     /**
@@ -4534,7 +4752,7 @@ export interface VideoUserImageDto extends AdditionalDataHolder, Parsable {
      */
     updatedAtUtc?: Date | null;
     /**
-     * The url property
+     * Absolute URL for the stored image object: a complete URL including scheme and host, ready torequest as-is.
      */
     url?: string | null;
     /**
@@ -4546,7 +4764,7 @@ export interface VideoUserImageDto extends AdditionalDataHolder, Parsable {
      */
     videoId?: Guid | null;
     /**
-     * The vttUrl property
+     * Absolute URL for the paired WebVTT metadata object when this image is a sprite sheet: acomplete URL including scheme and host, ready to request as-is.
      */
     vttUrl?: string | null;
     /**
@@ -4554,16 +4772,22 @@ export interface VideoUserImageDto extends AdditionalDataHolder, Parsable {
      */
     width?: number | null;
 }
+/**
+ * A single changed wanted video row in the incremental feed.
+ */
 export interface WantedVideoChangeDto extends AdditionalDataHolder, Parsable {
     /**
-     * The eventType property
+     * One of `created`, `updated`, or `deleted`.
      */
     eventType?: string | null;
     /**
-     * The wantedVideo property
+     * Current-state payload for a wanted video row in the incremental feed.
      */
     wantedVideo?: WantedVideoChangeWantedVideoDto | null;
 }
+/**
+ * Seek cursor for continuing a wanted video change feed.
+ */
 export interface WantedVideoChangesCursorDto extends AdditionalDataHolder, Parsable {
     /**
      * The id property
@@ -4574,6 +4798,9 @@ export interface WantedVideoChangesCursorDto extends AdditionalDataHolder, Parsa
      */
     updatedAtUtc?: Date | null;
 }
+/**
+ * Current-state payload for a wanted video row in the incremental feed.
+ */
 export interface WantedVideoChangeWantedVideoDto extends AdditionalDataHolder, Parsable {
     /**
      * The createdAtUtc property
@@ -4600,9 +4827,14 @@ export interface WantedVideoChangeWantedVideoDto extends AdditionalDataHolder, P
      */
     fulfillmentExternalId?: string | null;
     /**
-     * The imageCdnPath property
+     * Deprecated alias for `imageUrl`, carrying the identical value. The name claimed apath fragment that was never sent; read `imageUrl` instead. Removed in the next majorversion.
+     * @deprecated
      */
     imageCdnPath?: string | null;
+    /**
+     * Absolute URL for the video's primary image, if available: a complete URL including schemeand host, ready to request as-is.
+     */
+    imageUrl?: string | null;
     /**
      * The isDeleted property
      */
@@ -4636,13 +4868,16 @@ export interface WantedVideoChangeWantedVideoDto extends AdditionalDataHolder, P
      */
     videoTitle?: string | null;
 }
+/**
+ * A wanted video entry for the current user.
+ */
 export interface WantedVideoSummaryDto extends AdditionalDataHolder, Parsable {
     /**
-     * The createdAtUtc property
+     * When this wanted video entry was created.
      */
     createdAtUtc?: Date | null;
     /**
-     * The fulfilledAtUtc property
+     * When the wanted video was fulfilled, if applicable.
      */
     fulfilledAtUtc?: Date | null;
     /**
@@ -4654,44 +4889,49 @@ export interface WantedVideoSummaryDto extends AdditionalDataHolder, Parsable {
      */
     fulfillmentByApp?: number | null;
     /**
-     * The fulfillmentExternalId property
+     * External identifier from the fulfilling application, if applicable.
      */
     fulfillmentExternalId?: string | null;
     /**
-     * The imageCdnPath property
+     * Deprecated alias for `imageUrl`, carrying the identical value. The name claimed apath fragment that was never sent; read `imageUrl` instead. Removed in the next majorversion.
+     * @deprecated
      */
     imageCdnPath?: string | null;
     /**
-     * The isFulfilled property
+     * Absolute URL for the video's primary image, if available: a complete URL including schemeand host, ready to request as-is.
+     */
+    imageUrl?: string | null;
+    /**
+     * Whether this wanted video has been fulfilled.
      */
     isFulfilled?: boolean | null;
     /**
-     * The siteTitle property
+     * Title of the site this video belongs to.
      */
     siteTitle?: string | null;
     /**
-     * The updatedAtUtc property
+     * When this wanted video entry was last updated.
      */
     updatedAtUtc?: Date | null;
     /**
-     * The videoCreatedAtUtc property
+     * When the video was added to the database.
      */
     videoCreatedAtUtc?: Date | null;
     /**
-     * The videoId property
+     * ID of the wanted video.
      */
     videoId?: Guid | null;
     /**
-     * The videoReleaseDate property
+     * Release date of the video, if known.
      */
     videoReleaseDate?: DateOnly | null;
     /**
-     * The videoTitle property
+     * Video title.
      */
     videoTitle?: string | null;
 }
 /**
- * Allowed values: DrunkenSlug, NzbFinder, NzbPorn.
+ * Indexer source. Supported values: `DrunkenSlug`, `NzbFinder`, `NzbPorn`. Allowed values: DrunkenSlug, NzbFinder, NzbPorn.
  */
 export declare const IndexerFilehashLookupKeyDto_indexerSourceObject: {
     readonly DrunkenSlug: "DrunkenSlug";