comic-vine-sdk 1.3.2 → 2.0.1

package/lib/index.d.ts

@@ -0,0 +1,2716 @@
+import { RequestPriority, HttpClientContract, CacheStore, DedupeStore, RateLimitStore, HttpClientError } from '@http-client-toolkit/core';
+export { HttpClientContract as HttpClient } from '@http-client-toolkit/core';
+
+declare enum ResourceType {
+    Character = 4005,
+    Concept = 4015,
+    Episode = 4070,
+    Issue = 4000,
+    Location = 4020,
+    Movie = 4025,
+    Origin = 4030,
+    Person = 4040,
+    Power = 4035,
+    Promo = 1700,
+    Publisher = 4010,
+    Series = 4075,
+    StoryArc = 4045,
+    Team = 4060,
+    Thing = 4055,
+    Video = 2300,
+    VideoCategory = 2320,
+    VideoType = 2320,
+    Volume = 4050
+}
+
+type digit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+type oneToNine = Exclude<digit, 0>;
+type YYYY = `19${digit}${digit}` | `20${digit}${digit}`;
+type MM = `0${oneToNine}` | `1${0 | 1 | 2}`;
+type DD = `${0}${oneToNine}` | `${1 | 2}${digit}` | `3${0 | 1}`;
+type IsoDate = `${YYYY}-${MM}-${DD}`;
+
+type KeysMatching<T, V> = {
+    [K in keyof T]-?: T[K] extends V ? K : never;
+}[keyof T];
+type PickMatching<T, V> = Pick<T, KeysMatching<T, V>>;
+type PickFilters<T> = Partial<PickMatching<T, number> & PickMatching<T, string | null>>;
+
+interface BaseOptions<FieldKey> {
+    /**
+     * List of field names to include in the response.
+     * Use this if you want to reduce the size of the response payload
+     */
+    fieldList?: Array<FieldKey>;
+}
+interface PriorityOptions {
+    /**
+     * Priority level for the request (affects rate limiting behavior)
+     * - 'user': High priority, gets reserved capacity during activity
+     * - 'background': Lower priority, may be throttled during high user activity
+     */
+    priority?: RequestPriority;
+}
+interface RetrieveOptions<FieldKey> extends BaseOptions<FieldKey>, PriorityOptions {
+}
+interface ListOptions<FieldKey, Filter> extends BaseOptions<FieldKey>, PriorityOptions {
+    /**
+     * The number of results to display per page
+     * This value defaults to 100 and can not exceed this number
+     */
+    limit?: number;
+    /**
+     * Return results starting with the object at the offset specified
+     */
+    offset?: number;
+    /**
+     * The result set can be sorted by field in ascending or descending order
+     */
+    sort?: Sort;
+    /**
+     * The results can be filtered by field
+     */
+    filter?: Filter;
+}
+interface Sort {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+
+declare enum StatusCode {
+    OK = 1,
+    InvalidApiKey = 100,
+    ObjectNotFound = 101,
+    UrlFormatError = 102,
+    JsonpCallbackMissing = 103,
+    FilterError = 104,
+    SubscriberOnlyVideo = 105
+}
+
+interface Response<Result> {
+    error: 'OK';
+    limit: number;
+    offset: number;
+    numberOfPageResults: number;
+    numberOfTotalResults: number;
+    statusCode: StatusCode;
+    results: Result;
+}
+
+interface UrlBuilder {
+    retrieve<Key>(resourceType: ResourceType, id: number, requestOptions?: RetrieveOptions<Key> | undefined): string;
+    list<Resource, FilterType>(resourceType: ResourceType, requestOptions?: ListOptions<Resource, FilterType> | undefined): string;
+}
+
+type ValueOf<T> = T[keyof T];
+
+interface ResourceInterface {
+    retrieve(id: number, options?: Record<string, unknown>): Promise<unknown>;
+    list(options?: Record<string, unknown>): Promise<unknown> & AsyncIterable<unknown>;
+}
+declare abstract class BaseResource<Resource, ResourceListItem> implements ResourceInterface {
+    private httpClient;
+    private urlBuilder;
+    protected abstract resourceType: ResourceType;
+    constructor(httpClient: HttpClientContract, urlBuilder: UrlBuilder);
+    retrieve<FieldKey extends keyof Resource>(id: number, options?: RetrieveOptions<FieldKey>): Promise<Resource | Pick<Resource, FieldKey>>;
+    private fetchPage;
+    list<FieldKey extends keyof ResourceListItem>(options?: ListOptions<FieldKey, PickFilters<ResourceListItem>>): Promise<{
+        limit: number;
+        numberOfPageResults: number;
+        numberOfTotalResults: number;
+        offset: number;
+        data: (ResourceListItem | Pick<ResourceListItem, keyof ResourceListItem>)[];
+    }> & {
+        [Symbol.asyncIterator](): AsyncGenerator<Awaited<ResourceListItem> | Awaited<Pick<ResourceListItem, keyof ResourceListItem>>, void, unknown>;
+    };
+}
+
+declare class ResourceFactory {
+    private httpClient;
+    private urlBuilder;
+    private _resources;
+    constructor(httpClient: HttpClientContract, urlBuilder: UrlBuilder);
+    create<T extends keyof typeof this._resources>(name: T): InstanceType<(typeof this._resources)[T]>;
+}
+
+interface ApiResource {
+    apiDetailUrl: string;
+    id: number;
+    name: string | null;
+}
+interface SiteResource extends ApiResource {
+    siteDetailUrl: string;
+}
+interface IssueApiResource extends ApiResource {
+    issueNumber: string;
+}
+interface IssueSiteResource extends SiteResource {
+    issueNumber: string;
+}
+interface SiteResourceWithCount extends SiteResource {
+    count: string;
+}
+interface EpisodeApiResource extends ApiResource {
+    episodeNumber: string;
+}
+interface EpisodeSiteResource extends SiteResource {
+    episodeNumber: string;
+}
+interface PersonCreditSiteResource extends SiteResource {
+    role: string;
+}
+interface Death {
+    date: IsoString;
+    timezoneType: number;
+    timezone: string;
+}
+interface AssociatedImage {
+    caption: null;
+    id: number;
+    imageTags: string;
+    originalUrl: string;
+}
+interface Image {
+    iconUrl: string;
+    mediumUrl: string;
+    screenUrl: string;
+    screenLargeUrl: string;
+    smallUrl: string;
+    superUrl: string;
+    thumbUrl: string;
+    tinyUrl: string;
+    originalUrl: string;
+    imageTags: string;
+}
+type IsoString = string;
+
+interface CharacterDetails {
+    /**
+     * List of aliases the character is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the character detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * A date, if one exists, that the character was born on. Not an origin date.
+     */
+    birth: null | string;
+    /**
+     * List of characters that are enemies with this character.
+     */
+    characterEnemies: Array<SiteResource>;
+    /**
+     * List of characters that are friends with this character.
+     */
+    characterFriends: Array<SiteResource>;
+    /**
+     * Number of issues this character appears in.
+     */
+    countOfIssueAppearances: number;
+    /**
+     * List of the real life people who created this character.
+     */
+    creators: Array<SiteResource>;
+    /**
+     * Date the character was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the character was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the character.
+     */
+    deck: null | string;
+    /**
+     * Description of the character.
+     */
+    description: null | string;
+    /**
+     * Issue where the character made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource;
+    /**
+     * Gender of the character. Available options are: Male, Female, Other
+     */
+    gender: number;
+    /**
+     * Unique ID of the character.
+     */
+    id: number;
+    /**
+     * Main image of the character.
+     */
+    image: Image;
+    /**
+     * List of issues this character appears in.
+     */
+    issueCredits: Array<SiteResource>;
+    /**
+     * List of issues this character died in.
+     */
+    issuesDiedIn: Array<SiteResource>;
+    /**
+     * Movies the character was in.
+     */
+    movies: Array<SiteResource>;
+    /**
+     * Name of the character.
+     */
+    name: string;
+    /**
+     * The origin of the character. Human, Alien, Robot ...etc
+     */
+    origin: ApiResource | null;
+    /**
+     * List of super powers a character has.
+     */
+    powers: Array<ApiResource>;
+    /**
+     * The primary publisher a character is attached to.
+     */
+    publisher: ApiResource;
+    /**
+     * Real name of the character.
+     */
+    realName: null | string;
+    /**
+     * URL pointing to the character on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * List of story arcs this character appears in.
+     */
+    storyArcCredits: Array<SiteResource>;
+    /**
+     * List of teams that are enemies of this character.
+     */
+    teamEnemies: Array<SiteResource>;
+    /**
+     * List of teams that are friends with this character.
+     */
+    teamFriends: Array<SiteResource>;
+    /**
+     * List of teams this character is a member of.
+     */
+    teams: Array<SiteResource>;
+    /**
+     * List of comic volumes this character appears in.
+     */
+    volumeCredits: Array<SiteResource>;
+}
+
+interface CharacterListItem {
+    /**
+     * List of aliases the character is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the character detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * A date, if one exists, that the character was born on. Not an origin date.
+     */
+    birth: null | string;
+    /**
+     * Number of issues this character appears in.
+     */
+    countOfIssueAppearances: number;
+    /**
+     * Date the character was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the character was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the character.
+     */
+    deck: null | string;
+    /**
+     * Description of the character.
+     */
+    description: null | string;
+    /**
+     * Issue where the character made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource;
+    /**
+     * Gender of the character. Available options are: Male, Female, Other
+     */
+    gender: number;
+    /**
+     * Unique ID of the character.
+     */
+    id: number;
+    /**
+     * Main image of the character.
+     */
+    image: Image;
+    /**
+     * Name of the character.
+     */
+    name: string;
+    /**
+     * The origin of the character. Human, Alien, Robot ...etc
+     */
+    origin: ApiResource | null;
+    /**
+     * The primary publisher a character is attached to.
+     */
+    publisher: ApiResource;
+    /**
+     * Real name of the character.
+     */
+    realName: null | string;
+    /**
+     * URL pointing to the character on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+declare class Character extends BaseResource<CharacterDetails, CharacterListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface ConceptDetails {
+    /**
+     * List of aliases the concept is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the concept detail resource.
+     */
+    apiDetailUrl: string;
+    countOfIsssueAppearances: number;
+    /**
+     * Date the concept was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the concept was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the concept.
+     */
+    deck: string;
+    /**
+     * Description of the concept.
+     */
+    description: string;
+    /**
+     * Issue where the concept made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource;
+    /**
+     * Unique ID of the concept.
+     */
+    id: number;
+    /**
+     * Main image of the concept.
+     */
+    image: Image;
+    /**
+     * List of issues this concept appears in.
+     */
+    issueCredits: Array<SiteResource>;
+    /**
+     * Movies the concept was in.
+     */
+    movies: Array<SiteResource>;
+    /**
+     * Name of the concept.
+     */
+    name: string;
+    /**
+     * URL pointing to the concept on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this concept appeared in comics.
+     */
+    startYear: string;
+    /**
+     * List of comic volumes this concept appears in.
+     */
+    volumeCredits: Array<SiteResource>;
+}
+
+interface ConceptListItem {
+    /**
+     * List of aliases the concept is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the concept detail resource.
+     */
+    apiDetailUrl: string;
+    countOfIsssueAppearances: number;
+    /**
+     * Date the concept was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the concept was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the concept.
+     */
+    deck: string;
+    /**
+     * Description of the concept.
+     */
+    description: null | string;
+    /**
+     * Issue where the concept made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource | null;
+    /**
+     * Unique ID of the concept.
+     */
+    id: number;
+    /**
+     * Main image of the concept.
+     */
+    image: Image;
+    /**
+     * Name of the concept.
+     */
+    name: string;
+    /**
+     * URL pointing to the concept on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this concept appeared in comics.
+     */
+    startYear: null | string;
+}
+
+declare class Concept extends BaseResource<ConceptDetails, ConceptListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface EpisodeDetails {
+    /**
+     * The air date of the episode.
+     */
+    airDate: Date | null;
+    /**
+     * List of aliases the episode is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the episode detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * A list of characters that appear in this episode.
+     */
+    characterCredits: Array<SiteResource>;
+    characterDiedIn: Array<unknown>;
+    /**
+     * A list of concepts that appear in this episode.
+     */
+    conceptCredits: Array<SiteResource>;
+    /**
+     * Date the episode was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the episode was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the episode.
+     */
+    deck: null | string;
+    /**
+     * Description of the episode.
+     */
+    description: null | string;
+    /**
+     * The number assigned to the episode within a series.
+     */
+    episodeNumber: string;
+    /**
+     * A list of characters in which this episode is the first appearance of the character.
+     */
+    firstAppearanceCharacters: unknown;
+    /**
+     * A list of concepts in which this episode is the first appearance of the concept.
+     */
+    firstAppearanceConcepts: unknown;
+    /**
+     * A list of locations in which this episode is the first appearance of the location.
+     */
+    firstAppearanceLocations: unknown;
+    /**
+     * A list of things in which this episode is the first appearance of the object.
+     */
+    firstAppearanceObjects: unknown;
+    /**
+     * A list of storyarcs in which this episode is the first appearance of the story arc.
+     */
+    firstAppearanceStoryarcs: unknown;
+    /**
+     * A list of teams in which this episode is the first appearance of the team.
+     */
+    firstAppearanceTeams: unknown;
+    hasStaffReview: null | false | SiteResource;
+    /**
+     * Unique ID of the episode.
+     */
+    id: number;
+    /**
+     * Main image of the episode.
+     */
+    image: Image;
+    /**
+     * List of locations that appeared in this episode.
+     */
+    locationCredits: Array<SiteResource>;
+    /**
+     * Name of the episode.
+     */
+    name: string;
+    /**
+     * List of things that appeared in this episode.
+     */
+    objectCredits: Array<SiteResource>;
+    /**
+     * The series the episode belongs to.
+     */
+    series: SiteResource;
+    /**
+     * URL pointing to the episode on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * List of story arcs this episode appears in.
+     */
+    storyArcCredits: Array<SiteResource>;
+    /**
+     * List of teams that appear in this episode.
+     */
+    teamCredits: Array<SiteResource>;
+}
+
+interface EpisodeListItem {
+    /**
+     * The air date of the episode.
+     */
+    airDate: Date | null;
+    /**
+     * List of aliases the episode is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the episode detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Date the episode was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the episode was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the episode.
+     */
+    deck: null | string;
+    /**
+     * Description of the episode.
+     */
+    description: null | string;
+    episodeNumber: string;
+    hasStaffReview: null | false | SiteResource;
+    /**
+     * Unique ID of the episode.
+     */
+    id: number;
+    /**
+     * Main image of the episode.
+     */
+    image: Image;
+    /**
+     * Name of the episode.
+     */
+    name: string;
+    /**
+     * The series the episode belongs to.
+     */
+    series: SiteResource;
+    /**
+     * URL pointing to the episode on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+declare class Episode extends BaseResource<EpisodeDetails, EpisodeListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface IssueDetails {
+    /**
+     * List of aliases the issue is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the issue detail resource.
+     */
+    apiDetailUrl: string;
+    associatedImages: Array<AssociatedImage>;
+    /**
+     * A list of characters that appear in this issue.
+     */
+    characterCredits: Array<SiteResource>;
+    characterDiedIn: Array<SiteResource>;
+    /**
+     * A list of concepts that appear in this issue.
+     */
+    conceptCredits: Array<SiteResource>;
+    /**
+     * The publish date printed on the cover of an issue.
+     */
+    coverDate: Date;
+    /**
+     * Date the issue was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the issue was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the issue.
+     */
+    deck: null | string;
+    /**
+     * Description of the issue.
+     */
+    description: null | string;
+    /**
+     * A list of characters in which this issue is the first appearance of the character.
+     */
+    firstAppearanceCharacters: unknown;
+    /**
+     * A list of concepts in which this issue is the first appearance of the concept.
+     */
+    firstAppearanceConcepts: unknown;
+    /**
+     * A list of locations in which this issue is the first appearance of the location.
+     */
+    firstAppearanceLocations: unknown;
+    /**
+     * A list of things in which this issue is the first appearance of the object.
+     */
+    firstAppearanceObjects: unknown;
+    /**
+     * A list of storyarcs in which this issue is the first appearance of the story arc.
+     */
+    firstAppearanceStoryarcs: unknown;
+    /**
+     * A list of teams in which this issue is the first appearance of the team.
+     */
+    firstAppearanceTeams: unknown;
+    hasStaffReview: null | false | SiteResource;
+    /**
+     * Unique ID of the issue.
+     */
+    id: number;
+    /**
+     * Main image of the issue.
+     */
+    image: Image;
+    /**
+     * The number assigned to the issue within the volume set.
+     */
+    issueNumber: string;
+    /**
+     * List of locations that appeared in this issue.
+     */
+    locationCredits: Array<SiteResource>;
+    /**
+     * Name of the issue.
+     */
+    name: null | string;
+    /**
+     * List of things that appeared in this issue.
+     */
+    objectCredits: Array<SiteResource>;
+    /**
+     * List of people that worked on this issue.
+     */
+    personCredits: Array<PersonCreditSiteResource>;
+    /**
+     * URL pointing to the issue on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The date the issue was first sold in stores.
+     */
+    storeDate: Date | null;
+    /**
+     * List of story arcs this issue appears in.
+     */
+    storyArcCredits: Array<SiteResource>;
+    /**
+     * List of teams that appear in this issue.
+     */
+    teamCredits: Array<SiteResource>;
+    teamDisbandedIn: Array<SiteResource>;
+    /**
+     * The volume this issue is a part of.
+     */
+    volume: SiteResource;
+}
+
+interface IssueListItem {
+    /**
+     * List of aliases the issue is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the issue detail resource.
+     */
+    apiDetailUrl: string;
+    associatedImages: Array<AssociatedImage>;
+    /**
+     * The publish date printed on the cover of an issue.
+     */
+    coverDate: Date;
+    /**
+     * Date the issue was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the issue was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the issue.
+     */
+    deck: unknown;
+    /**
+     * Description of the issue.
+     */
+    description: null | string;
+    hasStaffReview: null | false | SiteResource;
+    /**
+     * Unique ID of the issue.
+     */
+    id: number;
+    /**
+     * Main image of the issue.
+     */
+    image: Image;
+    /**
+     * The number assigned to the issue within the volume set.
+     */
+    issueNumber: string;
+    /**
+     * Name of the issue.
+     */
+    name: null | string;
+    /**
+     * URL pointing to the issue on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The date the issue was first sold in stores.
+     */
+    storeDate: Date | null;
+    /**
+     * The volume this issue is a part of.
+     */
+    volume: SiteResource;
+}
+
+declare class Issue extends BaseResource<IssueDetails, IssueListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface LocationDetails {
+    /**
+     * List of aliases the location is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the location detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Number of issues this location appears in.
+     */
+    countOfIssueAppearances: number;
+    /**
+     * Date the location was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the location was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the location.
+     */
+    deck: string;
+    /**
+     * Description of the location.
+     */
+    description: string;
+    /**
+     * Issue where the location made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource;
+    /**
+     * Unique ID of the location.
+     */
+    id: number;
+    /**
+     * Main image of the location.
+     */
+    image: Image;
+    /**
+     * List of issues this location appears in.
+     */
+    issueCredits: Array<SiteResource>;
+    /**
+     * Movies the location was in.
+     */
+    movies: Array<SiteResource>;
+    /**
+     * Name of the location.
+     */
+    name: string;
+    /**
+     * URL pointing to the location on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this location appeared in comics.
+     */
+    startYear: string;
+    /**
+     * List of story arcs this location appears in.
+     */
+    storyArcCredits: Array<unknown>;
+    /**
+     * List of comic volumes this location appears in.
+     */
+    volumeCredits: Array<SiteResource>;
+}
+
+interface LocationListItem {
+    /**
+     * List of aliases the location is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the location detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Number of issues this location appears in.
+     */
+    countOfIssueAppearances: number;
+    /**
+     * Date the location was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the location was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the location.
+     */
+    deck: string;
+    /**
+     * Description of the location.
+     */
+    description: null | string;
+    /**
+     * Issue where the location made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource | null;
+    /**
+     * Unique ID of the location.
+     */
+    id: number;
+    /**
+     * Main image of the location.
+     */
+    image: Image;
+    /**
+     * Name of the location.
+     */
+    name: string;
+    /**
+     * URL pointing to the location on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this location appeared in comics.
+     */
+    startYear: null | string;
+}
+
+declare class Location extends BaseResource<LocationDetails, LocationListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface MovieDetails {
+    /**
+     * URL pointing to the movie detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * The total revenue made in the box offices for this movie.
+     */
+    boxOfficeRevenue: null | string;
+    /**
+     * The cost of making this movie.
+     */
+    budget: string;
+    /**
+     * Characters related to the movie.
+     */
+    characters: Array<SiteResource>;
+    /**
+     * Concepts related to the movie.
+     */
+    concepts: Array<SiteResource>;
+    /**
+     * Date the movie was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the movie was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the movie.
+     */
+    deck: string;
+    /**
+     * Description of the movie.
+     */
+    description: null | string;
+    hasStaffReview: null | false | SiteResource;
+    /**
+     * Unique ID of the movie.
+     */
+    id: number;
+    /**
+     * Main image of the movie.
+     */
+    image: Image;
+    /**
+     * Locations related to the movie.
+     */
+    locations: Array<SiteResource>;
+    /**
+     * Name of the movie.
+     */
+    name: string;
+    objects: Array<SiteResource>;
+    /**
+     * The producers of this movie.
+     */
+    producers: Array<SiteResource>;
+    /**
+     * The rating of this movie.
+     */
+    rating: string;
+    /**
+     * Date of the movie.
+     */
+    releaseDate: Date;
+    /**
+     * The length of this movie.
+     */
+    runtime: string;
+    /**
+     * URL pointing to the movie on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    studios: Array<SiteResource>;
+    /**
+     * List of teams this movie is a member of.
+     */
+    teams: Array<SiteResource>;
+    /**
+     * Total revenue generated by this movie.
+     */
+    totalRevenue: string;
+    /**
+     * Writers for this movie.
+     */
+    writers: Array<SiteResource>;
+}
+
+interface MovieListItem {
+    /**
+     * URL pointing to the movie detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * The total revenue made in the box offices for this movie.
+     */
+    boxOfficeRevenue: null | string;
+    /**
+     * The cost of making this movie.
+     */
+    budget: null | string;
+    /**
+     * Date the movie was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the movie was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the movie.
+     */
+    deck: null | string;
+    /**
+     * Description of the movie.
+     */
+    description: null | string;
+    hasStaffReview: null | false | SiteResource;
+    /**
+     * Unique ID of the movie.
+     */
+    id: number;
+    /**
+     * Main image of the movie.
+     */
+    image: Image;
+    /**
+     * Name of the movie.
+     */
+    name: string;
+    /**
+     * The producers of this movie.
+     */
+    producers: Array<SiteResource>;
+    /**
+     * The rating of this movie.
+     */
+    rating: null | string;
+    /**
+     * Date of the movie.
+     */
+    releaseDate: Date;
+    /**
+     * The length of this movie.
+     */
+    runtime: string;
+    /**
+     * URL pointing to the movie on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    studios: Array<SiteResource>;
+    /**
+     * Total revenue generated by this movie.
+     */
+    totalRevenue: null | string;
+    /**
+     * Writers for this movie.
+     */
+    writers: Array<SiteResource>;
+}
+
+declare class Movie extends BaseResource<MovieDetails, MovieListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface OriginDetails {
+    /**
+     * URL pointing to the origin detail resource.
+     */
+    apiDetailUrl: string;
+    characters: Array<ApiResource>;
+    characterSet: null;
+    /**
+     * Unique ID of the origin.
+     */
+    id: number;
+    /**
+     * Name of the origin.
+     */
+    name: string;
+    profiles: Array<unknown>;
+    /**
+     * URL pointing to the origin on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+interface OriginListItem {
+    /**
+     * URL pointing to the origin detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Unique ID of the origin.
+     */
+    id: number;
+    /**
+     * Name of the origin.
+     */
+    name: string;
+    /**
+     * URL pointing to the origin on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+declare class Origin extends BaseResource<OriginDetails, OriginListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface PersonDetails {
+    /**
+     * List of aliases the person is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the person detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * A date, if one exists, that the person was born on. Not an origin date.
+     */
+    birth: Date | null;
+    countOfIsssueAppearances: unknown;
+    /**
+     * Country the person resides in.
+     */
+    country: null | string;
+    /**
+     * Comic characters this person created.
+     */
+    createdCharacters: Array<SiteResource>;
+    /**
+     * Date the person was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the person was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Date this person died on.
+     */
+    death: Death | null;
+    /**
+     * Brief summary of the person.
+     */
+    deck: null | string;
+    /**
+     * Description of the person.
+     */
+    description: null | string;
+    /**
+     * The email of this person.
+     */
+    email: null | string;
+    /**
+     * Gender of the person. Available options are: Male, Female, Other
+     */
+    gender: number;
+    /**
+     * City or town the person resides in.
+     */
+    hometown: null | string;
+    /**
+     * Unique ID of the person.
+     */
+    id: number;
+    /**
+     * Main image of the person.
+     */
+    image: Image;
+    /**
+     * List of issues this person appears in.
+     */
+    issues: Array<SiteResource>;
+    /**
+     * Name of the person.
+     */
+    name: string;
+    /**
+     * URL pointing to the person on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * List of story arcs this person appears in.
+     */
+    storyArcCredits: Array<SiteResource>;
+    /**
+     * List of comic volumes this person appears in.
+     */
+    volumeCredits: Array<SiteResource>;
+    /**
+     * URL to the person website.
+     */
+    website: null | string;
+}
+
+interface PersonListItem {
+    /**
+     * List of aliases the person is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the person detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * A date, if one exists, that the person was born on. Not an origin date.
+     */
+    birth: Date | null;
+    countOfIsssueAppearances: unknown;
+    /**
+     * Country the person resides in.
+     */
+    country: null | string;
+    /**
+     * Date the person was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the person was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Date this person died on.
+     */
+    death: Death | null;
+    /**
+     * Brief summary of the person.
+     */
+    deck: null | string;
+    /**
+     * Description of the person.
+     */
+    description: null | string;
+    /**
+     * The email of this person.
+     */
+    email: null | string;
+    /**
+     * Gender of the person. Available options are: Male, Female, Other
+     */
+    gender: number;
+    /**
+     * City or town the person resides in.
+     */
+    hometown: null | string;
+    /**
+     * Unique ID of the person.
+     */
+    id: number;
+    /**
+     * Main image of the person.
+     */
+    image: {
+        [key: string]: null | string;
+    };
+    /**
+     * Name of the person.
+     */
+    name: string;
+    /**
+     * URL pointing to the person on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * URL to the person website.
+     */
+    website: null | string;
+}
+
+declare class Person extends BaseResource<PersonDetails, PersonListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface PowerDetails {
+    /**
+     * List of aliases the power is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the power detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Characters related to the power.
+     */
+    characters: Array<SiteResource>;
+    /**
+     * Date the power was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the power was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Description of the power.
+     */
+    description: null | string;
+    /**
+     * Unique ID of the power.
+     */
+    id: number;
+    /**
+     * Name of the power.
+     */
+    name: string;
+    /**
+     * URL pointing to the power on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+interface PowerListItem {
+    /**
+     * List of aliases the power is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the power detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Date the power was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the power was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Description of the power.
+     */
+    description: null | string;
+    /**
+     * Unique ID of the power.
+     */
+    id: number;
+    /**
+     * Name of the power.
+     */
+    name: string;
+    /**
+     * URL pointing to the power on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+declare class Power extends BaseResource<PowerDetails, PowerListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface PromoDetails {
+    /**
+     * URL pointing to the promo detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Date the promo was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Brief summary of the promo.
+     */
+    deck: string;
+    guid: string;
+    /**
+     * Unique ID of the promo.
+     */
+    id: number;
+    /**
+     * Main image of the promo.
+     */
+    image: Image;
+    /**
+     * The link that promo points to.
+     */
+    link: string;
+    /**
+     * Name of the promo.
+     */
+    name: string;
+    /**
+     * The type of resource the promo is pointing towards.
+     */
+    resourceType: string;
+    /**
+     * Author of the promo.
+     */
+    user: string;
+}
+
+interface PromoListItem {
+    /**
+     * URL pointing to the promo detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Date the promo was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Brief summary of the promo.
+     */
+    deck: string;
+    guid: string;
+    /**
+     * Unique ID of the promo.
+     */
+    id: number;
+    /**
+     * Main image of the promo.
+     */
+    image: Image;
+    /**
+     * The link that promo points to.
+     */
+    link: string;
+    /**
+     * Name of the promo.
+     */
+    name: string;
+    /**
+     * The type of resource the promo is pointing towards.
+     */
+    resourceType: string;
+    /**
+     * Author of the promo.
+     */
+    user: string;
+}
+
+declare class Promo extends BaseResource<PromoDetails, PromoListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface PublisherDetails {
+    /**
+     * List of aliases the publisher is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the publisher detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Characters related to the publisher.
+     */
+    characters: Array<SiteResource>;
+    /**
+     * Date the publisher was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the publisher was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the publisher.
+     */
+    deck: null | string;
+    /**
+     * Description of the publisher.
+     */
+    description: null | string;
+    /**
+     * Unique ID of the publisher.
+     */
+    id: number;
+    /**
+     * Main image of the publisher.
+     */
+    image: Image;
+    /**
+     * Street address of the publisher.
+     */
+    locationAddress: null | string;
+    /**
+     * City the publisher resides in.
+     */
+    locationCity: null | string;
+    /**
+     * State the publisher resides in.
+     */
+    locationState: null | string;
+    /**
+     * Name of the publisher.
+     */
+    name: string;
+    /**
+     * URL pointing to the publisher on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * List of story arcs tied to this publisher.
+     */
+    storyArcs: Array<SiteResource>;
+    /**
+     * List of teams this publisher is a member of.
+     */
+    teams: Array<SiteResource>;
+    /**
+     * List of volumes this publisher has put out.
+     */
+    volumes: Array<SiteResource>;
+}
+
+interface PublisherListItem {
+    /**
+     * List of aliases the publisher is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the publisher detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Date the publisher was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the publisher was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the publisher.
+     */
+    deck: null | string;
+    /**
+     * Description of the publisher.
+     */
+    description: null | string;
+    /**
+     * Unique ID of the publisher.
+     */
+    id: number;
+    /**
+     * Main image of the publisher.
+     */
+    image: Image;
+    /**
+     * Street address of the publisher.
+     */
+    locationAddress: null | string;
+    /**
+     * City the publisher resides in.
+     */
+    locationCity: null | string;
+    /**
+     * State the publisher resides in.
+     */
+    locationState: LocationState | null;
+    /**
+     * Name of the publisher.
+     */
+    name: string;
+    /**
+     * URL pointing to the publisher on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+declare enum LocationState {
+    California = "California",
+    NewYork = "New York",
+    LocationStateNewYork = "New York ",
+    Pennsylvania = "Pennsylvania"
+}
+
+declare class Publisher extends BaseResource<PublisherDetails, PublisherListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface SeriesDetails {
+    /**
+     * List of aliases the series is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the series detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * A list of characters that appear in this series.
+     */
+    characters: Array<SiteResourceWithCount>;
+    /**
+     * Number of episodes included in this series.
+     */
+    countOfEpisodes: number;
+    /**
+     * Date the series was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the series was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the series.
+     */
+    deck: null | string;
+    /**
+     * Description of the series.
+     */
+    description: string;
+    episodes: Array<EpisodeSiteResource>;
+    /**
+     * The first episode in this series.
+     */
+    firstEpisode: EpisodeApiResource;
+    /**
+     * Unique ID of the series.
+     */
+    id: number;
+    /**
+     * Main image of the series.
+     */
+    image: Image;
+    /**
+     * The last episode in this series.
+     */
+    lastEpisode: EpisodeApiResource;
+    /**
+     * Name of the series.
+     */
+    name: string;
+    /**
+     * The primary publisher a series is attached to.
+     */
+    publisher: ApiResource | null;
+    /**
+     * URL pointing to the series on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this series appeared in comics.
+     */
+    startYear: string;
+}
+
+interface SeriesListItem {
+    aliases: null | string;
+    apiDetailUrl: string;
+    countOfEpisodes: number;
+    dateAdded: Date;
+    dateLastUpdated: Date;
+    deck: null | string;
+    description: null | string;
+    firstEpisode: EpisodeApiResource;
+    id: number;
+    image: Image;
+    lastEpisode: EpisodeApiResource;
+    name: string;
+    publisher: ApiResource | null;
+    siteDetailUrl: string;
+    startYear: string;
+}
+
+declare class Series extends BaseResource<SeriesDetails, SeriesListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface StoryArcDetails {
+    /**
+     * List of aliases the story_arc is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the story_arc detail resource.
+     */
+    apiDetailUrl: string;
+    countOfIsssueAppearances: number;
+    /**
+     * Date the story_arc was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the story_arc was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the story_arc.
+     */
+    deck: string;
+    /**
+     * Description of the story_arc.
+     */
+    description: string;
+    episodes: Array<SiteResource>;
+    firstAppearedInEpisode: EpisodeApiResource | null;
+    /**
+     * Issue where the story_arc made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource;
+    /**
+     * Unique ID of the story_arc.
+     */
+    id: number;
+    /**
+     * Main image of the story_arc.
+     */
+    image: Image;
+    /**
+     * List of issues included in this story_arc.
+     */
+    issues: Array<SiteResource>;
+    /**
+     * Movies the story_arc was in.
+     */
+    movies?: Array<unknown>;
+    /**
+     * Name of the story_arc.
+     */
+    name: string;
+    /**
+     * The primary publisher a story_arc is attached to.
+     */
+    publisher: SiteResource;
+    /**
+     * URL pointing to the story_arc on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+interface StoryArcListItem {
+    /**
+     * List of aliases the story_arc is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the story_arc detail resource.
+     */
+    apiDetailUrl: string;
+    countOfIsssueAppearances: number;
+    /**
+     * Date the story_arc was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the story_arc was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the story_arc.
+     */
+    deck: null | string;
+    /**
+     * Description of the story_arc.
+     */
+    description: null | string;
+    firstAppearedInEpisode: EpisodeApiResource | null;
+    /**
+     * Issue where the story_arc made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource;
+    /**
+     * Unique ID of the story_arc.
+     */
+    id: number;
+    /**
+     * Main image of the story_arc.
+     */
+    image: Image;
+    /**
+     * Name of the story_arc.
+     */
+    name: string;
+    /**
+     * The primary publisher a story_arc is attached to.
+     */
+    publisher: SiteResource;
+    /**
+     * URL pointing to the story_arc on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+declare class StoryArc extends BaseResource<StoryArcDetails, StoryArcListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface TeamDetails {
+    /**
+     * List of aliases the team is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the team detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * List of characters that are enemies with this team.
+     */
+    characterEnemies: Array<SiteResource>;
+    /**
+     * List of characters that are friends with this team.
+     */
+    characterFriends: Array<SiteResource>;
+    /**
+     * Characters related to the team.
+     */
+    characters: Array<SiteResource>;
+    countOfIsssueAppearances: number;
+    /**
+     * Number of team members in this team.
+     */
+    countOfTeamMembers: number;
+    /**
+     * Date the team was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the team was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the team.
+     */
+    deck: string;
+    /**
+     * Description of the team.
+     */
+    description: string;
+    /**
+     * List of issues this team disbanded in.
+     */
+    disbandedInIssues: Array<SiteResource>;
+    /**
+     * Issue where the team made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource;
+    /**
+     * Unique ID of the team.
+     */
+    id: number;
+    /**
+     * Main image of the team.
+     */
+    image: Image;
+    isssuesDisbandedIn: Array<SiteResource>;
+    /**
+     * List of issues this team appears in.
+     */
+    issueCredits: Array<SiteResource>;
+    /**
+     * Movies the team was in.
+     */
+    movies: Array<SiteResource>;
+    /**
+     * Name of the team.
+     */
+    name: string;
+    /**
+     * The primary publisher a team is attached to.
+     */
+    publisher: ApiResource;
+    /**
+     * URL pointing to the team on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * List of story arcs this team appears in.
+     */
+    storyArcCredits: Array<SiteResource>;
+    /**
+     * List of comic volumes this team appears in.
+     */
+    volumeCredits: Array<SiteResource>;
+}
+
+interface TeamListItem {
+    /**
+     * List of aliases the team is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the team detail resource.
+     */
+    apiDetailUrl: string;
+    countOfIsssueAppearances: number;
+    /**
+     * Number of team members in this team.
+     */
+    countOfTeamMembers: number;
+    /**
+     * Date the team was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the team was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the team.
+     */
+    deck: string;
+    /**
+     * Description of the team.
+     */
+    description: null | string;
+    /**
+     * Issue where the team made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource;
+    /**
+     * Unique ID of the team.
+     */
+    id: number;
+    /**
+     * Main image of the team.
+     */
+    image: Image;
+    /**
+     * Name of the team.
+     */
+    name: string;
+    /**
+     * The primary publisher a team is attached to.
+     */
+    publisher: ApiResource;
+    /**
+     * URL pointing to the team on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+declare class Team extends BaseResource<TeamDetails, TeamListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface ThingDetails {
+    /**
+     * List of aliases the thing is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the thing detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Number of issues this thing appears in.
+     */
+    countOfIssueAppearances: number;
+    /**
+     * Date the thing was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the thing was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the thing.
+     */
+    deck: string;
+    /**
+     * Description of the thing.
+     */
+    description: null | string;
+    /**
+     * Issue where the thing made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource | null;
+    /**
+     * Unique ID of the thing.
+     */
+    id: number;
+    /**
+     * Main image of the thing.
+     */
+    image: Image;
+    /**
+     * List of issues this thing appears in.
+     */
+    issueCredits: Array<SiteResource>;
+    /**
+     * Movies the thing was in.
+     */
+    movies: Array<SiteResource>;
+    /**
+     * Name of the thing.
+     */
+    name: string;
+    /**
+     * URL pointing to the thing on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this thing appeared in comics.
+     */
+    startYear: null | string;
+    /**
+     * List of story arcs this thing appears in.
+     */
+    storyArcCredits: Array<SiteResource>;
+    /**
+     * List of comic volumes this thing appears in.
+     */
+    volumeCredits: Array<SiteResource>;
+}
+
+interface ThingListItem {
+    /**
+     * List of aliases the thing is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the thing detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Number of issues this thing appears in.
+     */
+    countOfIssueAppearances: number;
+    /**
+     * Date the thing was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the thing was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the thing.
+     */
+    deck: null | string;
+    /**
+     * Description of the thing.
+     */
+    description: null | string;
+    /**
+     * Issue where the thing made its first appearance.
+     */
+    firstAppearedInIssue: IssueApiResource | null;
+    /**
+     * Unique ID of the thing.
+     */
+    id: number;
+    /**
+     * Main image of the thing.
+     */
+    image: Image;
+    /**
+     * Name of the thing.
+     */
+    name: string;
+    /**
+     * URL pointing to the thing on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this thing appeared in comics.
+     */
+    startYear: null | string;
+}
+
+declare class Thing extends BaseResource<ThingDetails, ThingListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface VideoDetails {
+    /**
+     * URL pointing to the video detail resource.
+     */
+    apiDetailUrl: string;
+    crew: null | string;
+    /**
+     * Brief summary of the video.
+     */
+    deck: string;
+    embedPlayer: string;
+    guid: string;
+    /**
+     * URL to the High Res version of the video.
+     */
+    highUrl: string;
+    hosts: null | string;
+    /**
+     * Unique ID of the video.
+     */
+    id: number;
+    /**
+     * Main image of the video.
+     */
+    image: {
+        [key: string]: null | string;
+    };
+    /**
+     * Length (in seconds) of the video.
+     */
+    lengthSeconds: number;
+    /**
+     * URL to the Low Res version of the video.
+     */
+    lowUrl: string;
+    /**
+     * Name of the video.
+     */
+    name: string;
+    premium: boolean;
+    /**
+     * Date the video was published on Comic Vine.
+     */
+    publishDate: Date;
+    /**
+     * URL pointing to the video on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The video's filename.
+     */
+    url: string;
+    /**
+     * Author of the video.
+     */
+    user: null | string;
+    videoCategories: Array<SiteResource>;
+    videoType: string;
+    youtubeId: null | string;
+}
+
+interface VideoListItem {
+    /**
+     * URL pointing to the video detail resource.
+     */
+    apiDetailUrl: string;
+    crew: Crew | null;
+    /**
+     * Brief summary of the video.
+     */
+    deck: string;
+    embedPlayer: string;
+    guid: string;
+    /**
+     * URL to the High Res version of the video.
+     */
+    highUrl: string;
+    hosts: Hosts | null;
+    /**
+     * Unique ID of the video.
+     */
+    id: number;
+    /**
+     * Main image of the video.
+     */
+    image: {
+        [key: string]: null | string;
+    };
+    /**
+     * Length (in seconds) of the video.
+     */
+    lengthSeconds: number;
+    /**
+     * URL to the Low Res version of the video.
+     */
+    lowUrl: string;
+    /**
+     * Name of the video.
+     */
+    name: string;
+    premium: boolean;
+    /**
+     * Date the video was published on Comic Vine.
+     */
+    publishDate: Date;
+    /**
+     * URL pointing to the video on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The video's filename.
+     */
+    url: string;
+    /**
+     * Author of the video.
+     */
+    user: User | null;
+    videoCategories: Array<SiteResource>;
+    videoType: VideoType$1 | null;
+    youtubeId: null | string;
+}
+declare enum Crew {
+    Aclarkp = "aclarkp",
+    Buddyhutton = "buddyhutton",
+    Gmanfromheck = "gmanfromheck",
+    GmanfromheckRyanerikp = "gmanfromheck, ryanerikp",
+    GmanfromheckRyanerikpBuddyhutton = "gmanfromheck, ryanerikp, buddyhutton",
+    Ryanerikp = "ryanerikp",
+    RyanerikpBuddyhutton = "ryanerikp, buddyhutton"
+}
+declare enum Hosts {
+    Aclarkp = "aclarkp",
+    Buddyhutton = "buddyhutton",
+    Gmanfromheck = "gmanfromheck",
+    Inferiorego = "inferiorego",
+    Ryanerikp = "ryanerikp"
+}
+declare enum User {
+    Aclarkp = "aclarkp",
+    Buddyhutton = "buddyhutton",
+    Cadamien = "cadamien",
+    Gmanfromheck = "gmanfromheck",
+    Ryanerikp = "ryanerikp"
+}
+declare enum VideoType$1 {
+    Events = "Events",
+    Feature = "Feature",
+    FeatureEvents = "Feature, Events",
+    FeatureMysteryArtChallenge = "Feature, Mystery Art Challenge",
+    FeatureUnboxing = "Feature, Unboxing",
+    MysteryArtChallenge = "Mystery Art Challenge",
+    Review = "Review",
+    Trailer = "Trailer",
+    Unboxing = "Unboxing"
+}
+
+declare class Video extends BaseResource<VideoDetails, VideoListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface VideoCategoryDetails {
+    /**
+     * URL pointing to the video_category detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Brief summary of the video_category.
+     */
+    deck: null | string;
+    /**
+     * Unique ID of the video_category.
+     */
+    id: number;
+    image: Image;
+    /**
+     * Name of the video_category.
+     */
+    name: string;
+    /**
+     * URL pointing to the video_category on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+interface VideoCategoryListItem {
+    /**
+     * URL pointing to the video_category detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Brief summary of the video_category.
+     */
+    deck: null | string;
+    /**
+     * Unique ID of the video_category.
+     */
+    id: number;
+    image: Image;
+    /**
+     * Name of the video_category.
+     */
+    name: string;
+    /**
+     * URL pointing to the video_category on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+declare class VideoCategory extends BaseResource<VideoCategoryDetails, VideoCategoryListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface VideoTypeDetails {
+    /**
+     * URL pointing to the video_type detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Brief summary of the video_type.
+     */
+    deck: null | string;
+    /**
+     * Unique ID of the video_type.
+     */
+    id: number;
+    /**
+     * Name of the video_type.
+     */
+    name: string;
+    /**
+     * URL pointing to the video_type on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+interface VideoTypeListItem {
+    /**
+     * URL pointing to the video_type detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Brief summary of the video_type.
+     */
+    deck: null | string;
+    /**
+     * Unique ID of the video_type.
+     */
+    id: number;
+    /**
+     * Name of the video_type.
+     */
+    name: string;
+    /**
+     * URL pointing to the video_type on Giant Bomb.
+     */
+    siteDetailUrl: string;
+}
+
+declare class VideoType extends BaseResource<VideoTypeDetails, VideoTypeListItem> {
+    protected resourceType: ResourceType;
+}
+
+interface VolumeDetails {
+    /**
+     * List of aliases the volume is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the volume detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * A list of characters that appear in this volume.
+     */
+    characters?: Array<SiteResourceWithCount>;
+    /**
+     * A list of concepts that appear in this volume.
+     */
+    concepts?: Array<SiteResourceWithCount>;
+    /**
+     * Number of issues included in this volume.
+     */
+    countOfIssues: number;
+    /**
+     * Date the volume was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the volume was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the volume.
+     */
+    deck: null | string;
+    /**
+     * Description of the volume.
+     */
+    description: null | string;
+    /**
+     * The first issue in this volume.
+     */
+    firstIssue: IssueApiResource;
+    /**
+     * Unique ID of the volume.
+     */
+    id: number;
+    /**
+     * Main image of the volume.
+     */
+    image: Image;
+    issues: Array<IssueSiteResource>;
+    /**
+     * The last issue in this volume.
+     */
+    lastIssue: IssueApiResource;
+    /**
+     * Name of the volume.
+     */
+    name: string;
+    /**
+     * List of things that appeared in this volume.
+     */
+    objects?: Array<SiteResourceWithCount>;
+    people: Array<SiteResourceWithCount>;
+    /**
+     * The primary publisher a volume is attached to.
+     */
+    publisher: ApiResource;
+    /**
+     * URL pointing to the volume on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this volume appeared in comics.
+     */
+    startYear: string;
+}
+
+interface VolumeListItem {
+    /**
+     * List of aliases the volume is known by. A \n (newline) seperates each alias.
+     */
+    aliases: null | string;
+    /**
+     * URL pointing to the volume detail resource.
+     */
+    apiDetailUrl: string;
+    /**
+     * Number of issues included in this volume.
+     */
+    countOfIssues: number;
+    /**
+     * Date the volume was added to Comic Vine.
+     */
+    dateAdded: Date;
+    /**
+     * Date the volume was last updated on Comic Vine.
+     */
+    dateLastUpdated: Date;
+    /**
+     * Brief summary of the volume.
+     */
+    deck: null | string;
+    /**
+     * Description of the volume.
+     */
+    description: null | string;
+    /**
+     * The first issue in this volume.
+     */
+    firstIssue: IssueApiResource;
+    /**
+     * Unique ID of the volume.
+     */
+    id: number;
+    /**
+     * Main image of the volume.
+     */
+    image: Image;
+    /**
+     * The last issue in this volume.
+     */
+    lastIssue: IssueApiResource;
+    /**
+     * Name of the volume.
+     */
+    name: string;
+    /**
+     * The primary publisher a volume is attached to.
+     */
+    publisher: ApiResource;
+    /**
+     * URL pointing to the volume on Giant Bomb.
+     */
+    siteDetailUrl: string;
+    /**
+     * The first year this volume appeared in comics.
+     */
+    startYear: string;
+}
+
+declare class Volume extends BaseResource<VolumeDetails, VolumeListItem> {
+    protected resourceType: ResourceType;
+}
+
+type resources_Character = Character;
+declare const resources_Character: typeof Character;
+type resources_Concept = Concept;
+declare const resources_Concept: typeof Concept;
+type resources_Episode = Episode;
+declare const resources_Episode: typeof Episode;
+type resources_Issue = Issue;
+declare const resources_Issue: typeof Issue;
+type resources_Location = Location;
+declare const resources_Location: typeof Location;
+type resources_Movie = Movie;
+declare const resources_Movie: typeof Movie;
+type resources_Origin = Origin;
+declare const resources_Origin: typeof Origin;
+type resources_Person = Person;
+declare const resources_Person: typeof Person;
+type resources_Power = Power;
+declare const resources_Power: typeof Power;
+type resources_Promo = Promo;
+declare const resources_Promo: typeof Promo;
+type resources_Publisher = Publisher;
+declare const resources_Publisher: typeof Publisher;
+type resources_Series = Series;
+declare const resources_Series: typeof Series;
+type resources_StoryArc = StoryArc;
+declare const resources_StoryArc: typeof StoryArc;
+type resources_Team = Team;
+declare const resources_Team: typeof Team;
+type resources_Thing = Thing;
+declare const resources_Thing: typeof Thing;
+type resources_Video = Video;
+declare const resources_Video: typeof Video;
+type resources_VideoCategory = VideoCategory;
+declare const resources_VideoCategory: typeof VideoCategory;
+type resources_VideoType = VideoType;
+declare const resources_VideoType: typeof VideoType;
+type resources_Volume = Volume;
+declare const resources_Volume: typeof Volume;
+declare namespace resources {
+  export { resources_Character as Character, resources_Concept as Concept, resources_Episode as Episode, resources_Issue as Issue, resources_Location as Location, resources_Movie as Movie, resources_Origin as Origin, resources_Person as Person, resources_Power as Power, resources_Promo as Promo, resources_Publisher as Publisher, resources_Series as Series, resources_StoryArc as StoryArc, resources_Team as Team, resources_Thing as Thing, resources_Video as Video, resources_VideoCategory as VideoCategory, resources_VideoType as VideoType, resources_Volume as Volume };
+}
+
+type ResourceInstance = ReturnType<ResourceFactory['create']> & ResourceInterface;
+type ResourcePropertyMap = {
+    [K in keyof typeof resources as Uncapitalize<K>]: InstanceType<(typeof resources)[K]>;
+};
+/**
+ * Consolidated options interface for ComicVine client
+ */
+interface ComicVineOptions {
+    /** Comic Vine API key */
+    apiKey: string;
+    /** Base URL for the Comic Vine API */
+    baseUrl?: string;
+    /** Store implementations for caching, deduplication, and rate limiting */
+    stores?: {
+        cache?: CacheStore;
+        dedupe?: DedupeStore;
+        rateLimit?: RateLimitStore;
+    };
+    /** HTTP client configuration */
+    client?: {
+        /** Default cache TTL in seconds */
+        defaultCacheTTL?: number;
+        /** Whether to throw errors on rate limit violations */
+        throwOnRateLimit?: boolean;
+        /** Maximum time to wait for rate limit in milliseconds */
+        maxWaitTime?: number;
+    };
+}
+declare class ComicVine implements ResourcePropertyMap {
+    private resourceFactory;
+    private resourceCache;
+    private resourceNames;
+    private stores;
+    readonly character: ResourcePropertyMap['character'];
+    readonly concept: ResourcePropertyMap['concept'];
+    readonly episode: ResourcePropertyMap['episode'];
+    readonly issue: ResourcePropertyMap['issue'];
+    readonly location: ResourcePropertyMap['location'];
+    readonly movie: ResourcePropertyMap['movie'];
+    readonly origin: ResourcePropertyMap['origin'];
+    readonly person: ResourcePropertyMap['person'];
+    readonly power: ResourcePropertyMap['power'];
+    readonly promo: ResourcePropertyMap['promo'];
+    readonly publisher: ResourcePropertyMap['publisher'];
+    readonly series: ResourcePropertyMap['series'];
+    readonly storyArc: ResourcePropertyMap['storyArc'];
+    readonly team: ResourcePropertyMap['team'];
+    readonly thing: ResourcePropertyMap['thing'];
+    readonly video: ResourcePropertyMap['video'];
+    readonly videoCategory: ResourcePropertyMap['videoCategory'];
+    readonly videoType: ResourcePropertyMap['videoType'];
+    readonly volume: ResourcePropertyMap['volume'];
+    /**
+     * Create a new ComicVine client
+     * @param options - Configuration options for the client
+     */
+    constructor(options: ComicVineOptions);
+    private isResourceProperty;
+    private getResource;
+    getAvailableResources(): Array<string>;
+    hasResource(resourceName: string): boolean;
+    getResourceByName(resourceName: string): ResourceInstance | undefined;
+    isResourceLoaded(resourceName: string): boolean;
+    getCacheStats(): {
+        total: number;
+        loaded: number;
+        loadedResources: Array<string>;
+    };
+    clearCache(): Promise<void>;
+    getRateLimitStatus(resourceName: string): Promise<{
+        remaining: number;
+        resetTime: Date;
+        limit: number;
+    } | null>;
+    resetRateLimit(resourceName: string): Promise<void>;
+}
+
+interface ErrorDetails {
+    message: string;
+    help: string;
+}
+declare abstract class BaseError extends HttpClientError {
+    help: string;
+    constructor(details: ErrorDetails);
+}
+
+declare class GenericError extends BaseError {
+    constructor(message?: string);
+}
+
+declare const customError: (error: unknown) => GenericError;
+
+declare class ComicVineFilterError extends BaseError {
+    constructor();
+}
+
+/**
+ * @deprecated will be removed in the next major version, use ComicVineGenericRequestError instead!
+ */
+declare class ComicVineGenericError extends BaseError {
+    constructor(message?: string);
+}
+declare class ComicVineGenericRequestError extends ComicVineGenericError {
+    constructor(message?: string);
+}
+
+declare class ComicJsonpCallbackMissingError extends BaseError {
+    constructor();
+}
+
+declare class ComicVineObjectNotFoundError extends BaseError {
+    constructor();
+}
+
+declare class OptionsValidationError extends BaseError {
+    constructor(path: Array<string | number>, message: string);
+}
+
+declare class ComicVineSubscriberOnlyError extends BaseError {
+    constructor();
+}
+
+declare class ComicVineUnauthorizedError extends BaseError {
+    constructor();
+}
+
+declare class ComicVineUrlFormatError extends BaseError {
+    constructor();
+}
+
+export { type BaseOptions, ComicJsonpCallbackMissingError, ComicVine, ComicVineFilterError, ComicVineGenericError, ComicVineGenericRequestError, ComicVineObjectNotFoundError, type ComicVineOptions, ComicVineSubscriberOnlyError, ComicVineUnauthorizedError, ComicVineUrlFormatError, GenericError, type IsoDate, type ListOptions, OptionsValidationError, type PickFilters, type PriorityOptions, type Response, type RetrieveOptions, type Sort, StatusCode, type UrlBuilder, type ValueOf, customError, ComicVine as default };