coh-content-db 2.0.0-rc.6 → 2.0.0-rc.8

package/dist/coh-content-db.d.ts

@@ -1,8 +1,19 @@
-declare const ALIGNMENT: readonly ["H", "V", "P"];
+declare const ALIGNMENT: readonly ["hero", "villain", "praetorian"];
 type Alignment = typeof ALIGNMENT[number];
+type AlignmentExtended = Alignment
+/**
+ * The alignments available for Primal Earth characters - Hero and Villain.
+ */
+ | 'primal'
+/**
+ * All the alignments.
+ */
+ | 'all';
+declare function compareAlignment(a?: Alignment, b?: Alignment): number;
 
 declare const SEX: readonly ["M", "F"];
 type Sex = typeof SEX[number];
+declare function compareSex(a?: Sex, b?: Sex): number;
 
 /**
  * Some badge values differ based on the alignment or sex of the character.
@@ -28,15 +39,12 @@ interface ArchetypeData {
     readonly description?: string;
 }
 
-declare const ENHANCEMENT_CATEGORY: readonly ["DEFENSE_DEBUFF", "TO_HIT_DEBUFF", "TAUNT", "CONFUSE", "HEALING", "DEFENSE_BUFF", "RESIST_DAMAGE", "INTANGIBILITY", "SLEEP", "SLOW", "HOLD", "STUN", "IMMOBILIZE", "FEAR", "ENDURANCE_MODIFICATION", "ENDURANCE_REDUCTION", "RECHARGE_REDUCTION", "INTERRUPT_DURATION", "ACCURACY", "TO_HIT_BUFF", "DAMAGE", "KNOCKBACK", "RUN_SPEED", "JUMP", "FLY_SPEED", "RANGE"];
+declare const ENHANCEMENT_CATEGORY: readonly ["defense-debuff", "to-hit-debuff", "taunt", "confuse", "healing", "defense-buff", "resist-damage", "intangibility", "sleep", "slow", "hold", "stun", "immobilize", "fear", "endurance-modification", "endurance-reduction", "recharge-reduction", "interrupt-duration", "accuracy", "to-hit-buff", "damage", "knockback", "run-speed", "jump", "fly-speed", "range"];
 type EnhancementCategory = typeof ENHANCEMENT_CATEGORY[number];
 
-declare const BADGE_REQUIREMENT_TYPE: readonly ["PLAQUE", "BADGE", "INVENTION", "MISSION", "ARC", "TASK_FORCE", "INVENTION_PLUS_ONE"];
+declare const BADGE_REQUIREMENT_TYPE: readonly ["badge", "invention", "invention-plus-one", "location", "monument", "mission", "task"];
 type BadgeRequirementType = typeof BADGE_REQUIREMENT_TYPE[number];
 
-declare const PLAQUE_TYPE: string[];
-type PlaqueType = typeof PLAQUE_TYPE[number];
-
 /**
  * Tage type to indicate that a string will accept {@link https://www.markdownguide.org/|Markdown} format.
  */
@@ -47,61 +55,71 @@ interface Link {
     href: string;
 }
 
-interface BadgeRequirementData {
+interface LocationData {
     /**
-     * Key.
+     * Key of the {@link Zone} that the location references.
      */
-    readonly key: string;
+    readonly zoneKey?: string;
     /**
-     * Type of requirement.
+     * In-game `/loc` coordinates of the location.
      */
-    readonly type: BadgeRequirementType;
+    readonly coords?: Coords;
     /**
-     * Zone the requirement is located in.
+     * The type of icon to use if the location appears on a map. (Typically the Vidiot map icon).
      */
-    readonly zoneKey?: string;
+    readonly icon?: LocationIcon;
     /**
-     * /loc coordinates.
+     * The text that should appear in the location icon. (Typically a number or symbol from the Vidiot map).
      */
-    readonly loc?: number[];
+    readonly iconText?: string;
+}
+/**
+ * Coordinates as they appear using the in-game `/loc` command.
+ */
+type Coords = [number, number, number];
+type LocationIcon = 'badge' | 'plaque' | 'pedestal' | 'object';
+
+interface BadgeRequirementData {
     /**
-     * Is it a wall plaque or a physical monument?
+     * Unique key used to reference this badge requirement.
+     *
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
      */
-    readonly plaqueType?: PlaqueType;
+    readonly key: string;
     /**
-     * Plaque inscription.
+     * The requirement type.
      */
-    readonly plaqueInscription?: string;
+    readonly type: BadgeRequirementType;
     /**
-     * The number or letter the plaque appears as on Vidiot Maps.
+     * If the requirement involves a location, where it is.
      */
-    readonly vidiotMapKey?: string;
+    readonly location?: LocationData | LocationData[];
     /**
-     * The key of the badge for this requirement.
+     * If the requirement involves a badge, the badge key.
      */
     readonly badgeKey?: string;
     /**
-     * Mission name.
+     * If the requirement involves a mission, the mission key.
      */
-    readonly missionName?: string;
+    readonly missionKey?: string;
     /**
-     * {@link Contact} key for the story arc.
+     * If the requirement involves a monument, the text that is displayed thereon.
      */
-    readonly contactKey?: string;
+    readonly monumentText?: string;
     /**
-     * Level of the invention required.
+     * If the requirement involves crafting an invention, the Level of the invention required.
      */
     readonly inventionLevel?: number;
     /**
-     * The types of enhancements required to be crafted.
+     * If the requirement involves crafting an invention, the types of enhancements that will qualify.
      */
     readonly inventionTypes?: EnhancementCategory[];
     /**
-     * Number of invention crafts required.
+     * Number of times the task needs to be repeated.
      */
-    readonly inventionCount?: number;
+    readonly count?: number;
     /**
-     * Any additional notes.
+     * Additional information about the requirement.
      */
     readonly notes?: MarkdownString;
     /**
@@ -110,14 +128,46 @@ interface BadgeRequirementData {
     readonly links?: Link[];
 }
 
-declare const BADGE_TYPE: readonly ["EXPLORATION", "HISTORY", "ACCOMPLISHMENT", "ACHIEVEMENT", "ACCOLADE", "GLADIATOR", "VETERAN", "PVP", "INVENTION", "DEFEAT", "EVENT", "OUROBOROS", "CONSIGNMENT", "DAY_JOB", "AE"];
+declare const BADGE_TYPE: readonly ["exploration", "history", "accomplishment", "achievement", "accolade", "gladiator", "veteran", "pvp", "invention", "defeat", "event", "ouroboros", "consignment", "day-job", "architect-entertainment"];
 type BadgeType = typeof BADGE_TYPE[number];
 
+declare const MORALITY: readonly ["hero", "vigilante", "villain", "rogue", "resistance", "loyalist"];
+type Morality = typeof MORALITY[number];
+type MoralityExtended = Morality
+/**
+ * Any of the Primal Earth moralities - Hero, Vigilante, Villain, Rogue.
+ */
+ | 'primal'
+/**
+ * Either of the Praetorian Earth moralities - Resistance or Loyalist.
+ */
+ | 'praetorian'
+/**
+ * The moralities that roll up to the Hero {@link Alignment} - Hero and Vigilante.
+ */
+ | 'heroic'
+/**
+ * The moralities that roll up to the Villain {@link Alignment} - Villain and Rogue.
+ */
+ | 'villainous'
+/**
+ * Moralities with access to Paragon City - Hero, Vigilante and Rogue.
+ */
+ | 'paragon-city-access'
+/**
+ * Moralities with access to the Rogue Isles - Villain, Rogue and Vigilante.
+ */
+ | 'rogue-isles-access'
+/**
+ * All the moralities.
+ */
+ | 'all';
+
 interface BadgeData {
     /**
      * Unique key used to reference this badge.
      *
-     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
      */
     readonly key: string;
     /**
@@ -129,15 +179,15 @@ interface BadgeData {
      *
      * If the value differs by sex or alignment, include an {@link AlternateData} for each variant.
      */
-    readonly name: AlternateData<string>[];
+    readonly name: string | AlternateData<string>[];
     /**
-     * The character alignments that this badge is available to.
+     * The {@link MoralityExtended|moralities} that this badge is available to. If undefined then all moralities will be assumed.
      */
-    readonly alignment: Alignment[];
+    readonly morality?: MoralityExtended | MoralityExtended[];
     /**
      * The badge text as it appears in-game. May vary by character sex or alignment.
      */
-    readonly badgeText?: AlternateData<string>[];
+    readonly badgeText?: AlternateData<MarkdownString>[] | MarkdownString;
     /**
      * Short description of how to acquire the badge. Detailed instructions should go in the notes field.
      */
@@ -147,7 +197,7 @@ interface BadgeData {
      *
      * If the value differs by sex or alignment, include an {@link AlternateData} for each variant.
      */
-    readonly icon?: AlternateData<string>[];
+    readonly icon?: string | AlternateData<string>[];
     /**
      * Freeform notes or tips about the badge.
      */
@@ -157,45 +207,18 @@ interface BadgeData {
      */
     readonly links?: Link[];
     /**
-     * For exploration badges, the key of the {@link ZoneData|Zone} that this badge is found on.
-     */
-    readonly zoneKey?: string;
-    /**
-     * For exploration badges, the `/loc` coordinates of the badge.
-     */
-    readonly loc?: [number, number, number];
-    /**
-     * For plaques that appear on a Vidiot Map, the number or letter the badge appears as.
-     */
-    readonly vidiotMapKey?: string;
-    /**
-     * ID used with the in-game `/settitle` command to apply the badge.
+     * The id used with the in-game `/settitle` command to apply the badge.
+     * The first value is the id for primal characters and the (optional) second number is the id for praetorian characters.
      */
-    readonly setTitle?: {
-        /**
-         * `/settitle` id.
-         */
-        id?: number;
-        /**
-         * `/settitle` id if different for praetorian characters.
-         */
-        praetorianId?: number;
-    };
+    readonly setTitleId?: [number, number?];
     /**
      * A description of the effect the badge will have, such as a buff or granting a temporary power.
      */
     readonly effect?: MarkdownString;
     /**
-     * Represents the layered requirements for badges with multiple fulfillment steps,
-     * such as visiting plaques for history badges or collecting other badges.
-     *
-     * The outer array represents groups of requirements evaluated with OR logic —
-     * fulfilling any group satisfies the badge.
-     *
-     * Each inner array represents individual requirements evaluated with AND logic —
-     * all conditions in the group must be met.
+     * Represents the requirements for badges with multiple fulfillment steps, such as visiting monuments for history badges, completing missions, or collecting other badges.
      */
-    readonly requirements?: BadgeRequirementData[][];
+    readonly requirements?: BadgeRequirementData[];
     /**
      * Some badges are not included in the badge total count... such as Flames of Prometheus, which can be removed by redeeming it for a Notice of the Well.
      */
@@ -221,7 +244,7 @@ interface ContactData {
     /**
      * Unique key used to reference this contact.
      *
-     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
      */
     readonly key: string;
     /**
@@ -233,13 +256,13 @@ interface ContactData {
      */
     readonly title?: string;
     /**
-     * The zone this character is located in.
+     * The character moralities that this contact will interact with.
      */
-    readonly zoneKey?: string;
+    readonly morality?: MoralityExtended | MoralityExtended[];
     /**
-     * The `/loc` coordinates of the contact.
+     * The location of this contact.
      */
-    readonly loc?: [number, number, number];
+    readonly location?: LocationData;
     /**
      * The level range this contact will offer missions for.
      */
@@ -258,7 +281,7 @@ interface ZoneData {
     /**
      * Unique key used to reference this zone.
      *
-     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
      */
     readonly key: string;
     /**
@@ -271,6 +294,74 @@ interface ZoneData {
     readonly links?: Link[];
 }
 
+declare const MISSION_TYPE: readonly ["story-arc", "mission", "task-force", "strike-force", "trial", "personal-story"];
+type MissionType = typeof MISSION_TYPE[number];
+
+interface MissionData {
+    /**
+     * Unique key used to reference this mission.
+     *
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
+     */
+    readonly key: string;
+    /**
+     * The name of the mission as it appears from the contact.
+     *
+     * The name may be different when viewed in Ouroboros as a Flashback.
+     */
+    readonly name: string;
+    /**
+     * The type of mission... Story arc, task force, trial, etc.
+     */
+    readonly type: MissionType;
+    /**
+     * The character moralities that may accept the mission.
+     */
+    readonly morality?: MoralityExtended | MoralityExtended[];
+    /**
+     * The keys of any contacts that provide this mission.
+     */
+    readonly contactKeys?: string | string[];
+    /**
+     * The level range this mission is available for.
+     */
+    readonly levelRange?: [number, number?];
+    /**
+     * Freeform notes or tips about the mission.
+     */
+    readonly notes?: MarkdownString;
+    /**
+     * List of external links. Wiki, forums, etc.
+     */
+    readonly links?: Link[];
+    /**
+     * If the mission is available in Ouroboros as a Flashback.
+     */
+    readonly flashback?: MissionFlashbackData;
+}
+interface MissionFlashbackData {
+    /**
+     * The id of the mission as seen in the Flashback menu, i.e. '14.01'.
+     */
+    readonly id: string;
+    /**
+     * The level range this mission appears under as a Flashback. Leave undefined if the same as the base mission.
+     */
+    readonly levelRange?: [number, number?];
+    /**
+     * The name as it appears in the Flashback list. Leave undefined if the same as the base mission.
+     */
+    readonly name?: string;
+    /**
+     * The character moralities that the mission will appear for in the Flashback list. Leave undefined if the same as the base mission.
+     */
+    readonly morality?: MoralityExtended | MoralityExtended[];
+    /**
+     * Freeform notes or tips about the Flashback version of the mission.
+     */
+    readonly notes?: MarkdownString;
+}
+
 /**
  * A content bundle holds the data that makes up one forked instance of the game since the original sunset, such as Homecoming (https://forums.homecomingservers.com/).
  */
@@ -308,6 +399,10 @@ interface ContentBundle {
      * List of contacts available in this fork.
      */
     readonly contacts?: ContactData[];
+    /**
+     * List of missions available in this fork.
+     */
+    readonly missions?: MissionData[];
     /**
      * List of badges available on this fork.
      */
@@ -318,18 +413,25 @@ interface ContentBundle {
     readonly changelog?: Change[];
 }
 
-declare class Alignments {
-    readonly items: Alignment[];
+declare class AlignmentList {
+    #private;
     readonly hero: boolean;
     readonly villain: boolean;
     readonly praetorian: boolean;
     readonly primal: boolean;
-    constructor(raw: Alignment[]);
+    readonly all: boolean;
+    constructor(items?: AlignmentExtended[]);
+    get items(): Alignment[];
+    has(alignment?: AlignmentExtended): boolean;
 }
 
 declare class Alternates<T> {
     #private;
-    constructor(values: AlternateData<T>[]);
+    /**
+     * Create an alternate set from either a list of categorized values, or a single value when there are no alternates.
+     * @param value List of alternates, or a single value.
+     */
+    constructor(value: AlternateData<T>[] | T);
     getValue(alignment?: Alignment, sex?: Sex): T | undefined;
     /**
      * Get the default value for this list of alternates, the value with the highest priority and lowest specificity.
@@ -353,61 +455,67 @@ declare class Archetype {
     constructor(data: ArchetypeData);
 }
 
-declare class BadgeRequirement {
+declare class Location {
     /**
-     * Key.
+     * Key of the {@link Zone} that the location references.
      */
-    readonly key: string;
+    readonly zoneKey?: string;
     /**
-     * Type of requirement.
+     * In-game `/loc` coordinates of the location.
      */
-    readonly type: BadgeRequirementType;
+    readonly coords?: Coords;
     /**
-     * Zone the requirement is located in.
+     * The type of icon to use if the location appears on a map. (Typically the Vidiot map icon).
      */
-    readonly zoneKey?: string;
+    readonly icon?: LocationIcon;
     /**
-     * /loc coordinates.
+     * The text that should appear in the location icon. (Typically a number or symbol from the Vidiot map).
      */
-    readonly loc?: number[];
+    readonly iconText?: string;
+    constructor(data: LocationData);
+}
+
+declare class BadgeRequirement {
     /**
-     * Is it a wall plaque or a physical monument?
+     * Unique key used to reference this badge requirement.
+     *
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
      */
-    readonly plaqueType?: PlaqueType;
+    readonly key: string;
     /**
-     * Plaque inscription.
+     * The requirement type.
      */
-    readonly plaqueInscription?: string;
+    readonly type: BadgeRequirementType;
     /**
-     * The number or letter the plaque appears as on Vidiot Maps.
+     * If the requirement involves a location, where it is.
      */
-    readonly vidiotMapKey?: string;
+    readonly location?: Location[];
     /**
-     * The key of the badge for this requirement.
+     * If the requirement involves a badge, the badge key.
      */
     readonly badgeKey?: string;
     /**
-     * Mission name.
+     * If the requirement involves a mission, the mission key.
      */
-    readonly missionName?: string;
+    readonly missionKey?: string;
     /**
-     * {@link Contact} key for the story arc.
+     * If the requirement involves a monument, the text that is displayed thereon.
      */
-    readonly contactKey?: string;
+    readonly monumentText?: string;
     /**
-     * Level of the invention required.
+     * If the requirement involves crafting an invention, the Level of the invention required.
      */
     readonly inventionLevel?: number;
     /**
-     * The types of enhancements required to be crafted.
+     * If the requirement involves crafting an invention, the types of enhancements that will qualify.
      */
     readonly inventionTypes?: EnhancementCategory[];
     /**
-     * Number of invention crafts required.
+     * Number of times the task needs to be repeated.
      */
-    readonly inventionCount?: number;
+    readonly count?: number;
     /**
-     * Any additional notes.
+     * Additional information about the requirement.
      */
     readonly notes?: MarkdownString;
     /**
@@ -417,6 +525,26 @@ declare class BadgeRequirement {
     constructor(data: BadgeRequirementData);
 }
 
+declare class MoralityList {
+    #private;
+    readonly hero: boolean;
+    readonly vigilante: boolean;
+    readonly villain: boolean;
+    readonly rogue: boolean;
+    readonly resistance: boolean;
+    readonly loyalist: boolean;
+    readonly primal: boolean;
+    readonly praetorian: boolean;
+    readonly heroic: boolean;
+    readonly villainous: boolean;
+    readonly paragonCityAccess: boolean;
+    readonly rogueIslesAccess: boolean;
+    readonly all: boolean;
+    constructor(items?: MoralityExtended[]);
+    get items(): Morality[];
+    has(morality?: MoralityExtended): boolean;
+}
+
 declare class Badge {
     #private;
     /**
@@ -434,13 +562,13 @@ declare class Badge {
      */
     readonly name: Alternates<string>;
     /**
-     * The character alignments that this badge is available to.
+     * The character moralities that this badge is available to.
      */
-    readonly alignment: Alignments;
+    readonly morality: MoralityList;
     /**
      * The badge text as it appears in-game. May vary by character sex or alignment.
      */
-    readonly badgeText: Alternates<string>;
+    readonly badgeText: Alternates<MarkdownString>;
     /**
      * Short description of how to acquire the badge. Detailed instructions will be in the notes field.
      */
@@ -460,52 +588,35 @@ declare class Badge {
      */
     readonly links: Link[];
     /**
-     * For exploration badges, the key of the {@link Zone} that this badge is found on.
-     */
-    readonly zoneKey?: string;
-    /**
-     * For exploration badges, the `/loc` coordinates of the badge.
+     * The id used with the in-game `/settitle` command to apply the badge.
+     * The first value is the id for primal characters and the (optional) second number is the id for praetorian characters.
      */
-    readonly loc?: [number, number, number];
-    /**
-     * For plaques that appear on a Vidiot Map, the number or letter the badge appears as.
-     */
-    readonly vidiotMapKey?: string;
-    /**
-     * ID used with the in-game `/settitle` command to apply the badge.
-     */
-    readonly setTitle?: {
-        /**
-         * `/settitle` id.
-         */
-        id?: number;
-        /**
-         * `/settitle` id if different for praetorian characters.
-         */
-        praetorianId?: number;
-    };
+    readonly setTitleId?: [number, number?];
     /**
      * A description of the effect the badge will have, such as a buff or granting a temporary power.
      */
     readonly effect?: MarkdownString;
     /**
-     * Represents the layered requirements for badges with multiple fulfillment steps,
-     * such as visiting plaques for history badges or collecting other badges.
-     *
-     * The outer array represents groups of requirements evaluated with OR logic —
-     * fulfilling any group satisfies the badge.
-     *
-     * Each inner array represents individual requirements evaluated with AND logic —
-     * all conditions in the group must be met.
+     * Represents the requirements for badges with multiple fulfillment steps, such as visiting monuments for history badges, completing missions, or collecting other badges.
      */
-    readonly requirements?: BadgeRequirement[][];
+    readonly requirements?: BadgeRequirement[];
     /**
      * Some badges are not included in the badge total count... such as Flames of Prometheus, which can be removed by redeeming it for a Notice of the Well.
      */
     readonly ignoreInTotals: boolean;
     constructor(badgeData: BadgeData);
     getRequirement(key: string): BadgeRequirement;
+    /**
+     * Return a list of all the zone keys referenced by this badge.
+     */
+    get zoneKeys(): string[];
+    /**
+     * The zone key if this badge relates to a single zone.
+     */
+    get zoneKey(): string | undefined;
 }
+declare function compareByDefaultName(a?: Badge, b?: Badge): number;
+declare function compareByZoneKey(a?: Badge, b?: Badge): number;
 
 interface BadgeSearchOptions {
     /**
@@ -530,7 +641,7 @@ interface BadgeSearchOptions {
     filter?: {
         type?: BadgeType;
         zoneKey?: string;
-        alignment?: Alignment;
+        morality?: MoralityExtended;
     };
     /**
      * Sort results.
@@ -538,8 +649,8 @@ interface BadgeSearchOptions {
      * Badges are assumed to be in canonical order in the content bundle, and should match the in-game display order.
      */
     sort?: {
-        by?: 'CANONICAL' | 'BADGE_NAME' | 'ZONE_NAME';
-        dir?: 'ASC' | 'DESC';
+        by?: 'canonical' | 'badge-name' | 'zone-key';
+        dir?: 'asc' | 'desc';
     };
     /**
      * The page (1-based)
@@ -551,24 +662,6 @@ interface BadgeSearchOptions {
     pageSize?: number;
 }
 
-declare class Zone {
-    /**
-     * Unique key used to reference this zone.
-     *
-     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
-     */
-    readonly key: string;
-    /**
-     * The name of the zone as it appears in-game.
-     */
-    readonly name: string;
-    /**
-     * List of external links. Wiki, forums, etc.
-     */
-    readonly links: Link[];
-    constructor(data: ZoneData);
-}
-
 interface Paged<T> {
     items: T[];
     page: number;
@@ -577,12 +670,34 @@ interface Paged<T> {
     totalPages: number;
 }
 
-declare class BadgeIndex {
+type KeysOfType<T, V> = {
+    [P in keyof T]: T[P] extends V ? P : never;
+}[keyof T];
+declare class AbstractIndex<T> {
     #private;
-    constructor(badges: Badge[], zones?: Zone[]);
-    getBadge(key: string): Badge;
-    badgeExists(key: string): boolean;
-    searchBadges(options?: BadgeSearchOptions): Paged<Badge>;
+    protected _values: T[];
+    protected _hashTable: Record<string, T>;
+    constructor(keyField: KeysOfType<T, string>);
+    /**
+     * Return all indexed values
+     */
+    get values(): T[];
+    /**
+     * Load the given list of values into the index, replacing any existing data.
+     * @param values List of values.
+     */
+    load(values: T[] | undefined): void;
+    /**
+     * Get a value from the index
+     * @param key Key string
+     */
+    get(key: string | undefined): T | undefined;
+}
+
+declare class BadgeIndex extends AbstractIndex<Badge> {
+    #private;
+    constructor();
+    search(options?: BadgeSearchOptions): Paged<Badge>;
 }
 
 declare class BundleMetadata {
@@ -601,19 +716,41 @@ declare class BundleMetadata {
     /**
      * List of external links. Wiki, forums, etc.
      */
-    readonly links: Link[];
+    readonly links?: Link[];
     /**
      * Change log for this data package.
      */
-    readonly changelog: Change[];
+    readonly changelog?: Change[];
+    /**
+     * The current version of the data package.
+     */
+    readonly version?: string;
     constructor(bundle: ContentBundle);
 }
 
+declare class Zone {
+    /**
+     * Unique key used to reference this zone.
+     *
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
+     */
+    readonly key: string;
+    /**
+     * The name of the zone as it appears in-game.
+     */
+    readonly name: string;
+    /**
+     * List of external links. Wiki, forums, etc.
+     */
+    readonly links: Link[];
+    constructor(data: ZoneData);
+}
+
 declare class Contact {
     /**
      * Unique key used to reference this contact.
      *
-     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
      */
     readonly key: string;
     /**
@@ -625,13 +762,13 @@ declare class Contact {
      */
     readonly title?: string;
     /**
-     * The zone this character is located in.
+     * The character moralities that this contact will interact with.
      */
-    readonly zoneKey?: string;
+    readonly morality?: MoralityList;
     /**
-     * The `/loc` coordinates of the contact.
+     * The location of this contact.
      */
-    readonly loc?: [number, number, number];
+    readonly location?: Location;
     /**
      * The level range this contact will offer missions for.
      */
@@ -644,49 +781,136 @@ declare class Contact {
      * List of external links. Wiki, forums, etc.
      */
     readonly links: Link[];
-    constructor(contactData: ContactData);
+    constructor(data: ContactData);
+}
+
+declare class Mission {
+    /**
+     * Unique key used to reference this mission.
+     *
+     * Keys must be unique and can only contain lowercase letters, numbers and hyphens (`-`).
+     */
+    readonly key: string;
+    /**
+     * The name of the mission as it appears from the contact.
+     *
+     * The name may be different when viewed in Ouroboros as a Flashback.
+     */
+    readonly name: string;
+    /**
+     * The type of mission... Story arc, task force, trial, etc.
+     */
+    readonly type: MissionType;
+    /**
+     * The character moralities that may accept the mission.
+     */
+    readonly morality: MoralityList;
+    /**
+     * The keys of any contacts that provide this mission.
+     */
+    readonly contactKeys?: string[];
+    /**
+     * The level range this mission is available for.
+     */
+    readonly levelRange?: [number, number?];
+    /**
+     * Freeform notes or tips about the mission.
+     */
+    readonly notes?: MarkdownString;
+    /**
+     * List of external links. Wiki, forums, etc.
+     */
+    readonly links: Link[];
+    /**
+     * If the mission is available in Ouroboros as a Flashback.
+     */
+    readonly flashback?: {
+        /**
+         * The id of the mission as seen in the Flashback menu, i.e. '14.01'.
+         */
+        readonly id: string;
+        /**
+         * The level range this mission appears under as a Flashback. Leave undefined if the same as the base mission.
+         */
+        readonly levelRange?: [number, number?];
+        /**
+         * The name as it appears in the Flashback list. Leave undefined if the same as the base mission.
+         */
+        readonly name?: string;
+        /**
+         * The character moralities that the mission will appear for in the Flashback list. Leave undefined if the same as the base mission.
+         */
+        readonly morality?: MoralityList;
+        /**
+         * Freeform notes or tips about the Flashback version of the mission.
+         */
+        readonly notes?: MarkdownString;
+    };
+    constructor(data: MissionData);
 }
 
 declare class CohContentDatabase {
     #private;
+    /**
+     * Load the given content bundle, resetting the db if a bundle is already loaded.
+     * @param bundle The bundle to load.
+     */
+    load(bundle: ContentBundle): void;
     /**
      * Metadata about the content bundle.
      */
-    readonly metadata: BundleMetadata;
+    get metadata(): BundleMetadata | undefined;
     /**
      * List of the game server names.
      *
      * Torchbearer, Excelsior, etc.
      */
-    readonly servers: string[];
+    get servers(): string[];
     /**
      * List of archetypes.
      */
-    readonly archetypes: Archetype[];
+    get archetypes(): Archetype[];
+    /**
+     * Get archetype by key.
+     * @param key The key.
+     */
+    getArchetype(key: string | undefined): Archetype | undefined;
     /**
      * List of game zones.
      */
-    readonly zones: Zone[];
+    get zones(): Zone[];
+    /**
+     * Get zone by key.
+     * @param key The key.
+     */
+    getZone(key: string | undefined): Zone | undefined;
     /**
      * List of contacts.
      */
-    readonly contacts: Contact[];
+    get contacts(): Contact[];
+    /**
+     * Get contact by key.
+     * @param key The key.
+     */
+    getContact(key: string | undefined): Contact | undefined;
+    /**
+     * List of missions.
+     */
+    get missions(): Mission[];
+    /**
+     * Get mission by key.
+     * @param key The key.
+     */
+    getMission(key: string | undefined): Mission | undefined;
     /**
      * List of badges.
      */
-    readonly badges: Badge[];
+    get badges(): Badge[];
     /**
-     * Initialize the database with a content bundle.
-     * @param bundle The data to load.
+     * Get badge by key.
+     * @param key The key.
      */
-    constructor(bundle: ContentBundle);
-    getArchetype(key: string): Archetype;
-    getZone(key: string): Zone;
-    getContact(key: string): Contact;
-    zoneExists(key: string): boolean;
-    contactExists(key: string): boolean;
-    getBadge(key: string): Badge;
-    badgeExists(key: string): boolean;
+    getBadge(key: string | undefined): Badge | undefined;
     /**
      * Search, sort and filter the badge list.
      * This is a fairly brute-forced approach and will not be as performant as loading the badge data into a traditional
@@ -705,7 +929,7 @@ declare class Key {
 declare const CHANGELOG: Change[];
 
 /**
- * Returns the URI of the given badge that can be used in {@link MarkdownString} links.
+ * Returns the URI of the given badge that can be used in {@link MarkdownString} fields.
  *
  * URI format: `badge://<key>`
  *
@@ -721,7 +945,7 @@ declare function badgeUri(target: string | Badge | BadgeData): string;
  */
 declare function badgeLink(target: string | Badge | BadgeData): string;
 /**
- * Returns the URI of the given contact that can be used in {@link MarkdownString} links.
+ * Returns the URI of the given contact that can be used in {@link MarkdownString} fields.
  *
  * URI format: `contact://<key>`
  *
@@ -737,7 +961,23 @@ declare function contactUri(target: string | Contact | ContactData): string;
  */
 declare function contactLink(target: string | Contact | ContactData): string;
 /**
- * Returns the URI of the given zone that can be used in {@link MarkdownString} links.
+ * Returns the URI of the given mission that can be used in {@link MarkdownString} fields.
+ *
+ * URI format: `mission://<key>`
+ *
+ * @param target The {@link Mission} or mission key to target.
+ */
+declare function missionUri(target: string | Mission | MissionData): string;
+/**
+ * Returns a {@link MarkdownString} link to the given mission.
+ *
+ * Link format: `[<key>](mission://<key>)`
+ *
+ * @param target The {@link Mission} or mission key to target.
+ */
+declare function missionLink(target: string | Mission | MissionData): string;
+/**
+ * Returns the URI of the given zone that can be used in {@link MarkdownString} fields.
  *
  * URI format: `zone://<key>`
  *
@@ -752,5 +992,15 @@ declare function zoneUri(target: string | Zone | ZoneData): string;
  * @param target The {@link Zone} or zone key to target.
  */
 declare function zoneLink(target: string | Zone | ZoneData): string;
+/**
+ * For fields that accept either an array of values or a single value, coalesces the value to an array.
+ *
+ * Arrays are returned as-is.
+ * Single values are returned as a single-value array.
+ * Undefined values are returned as undefined.
+ *
+ * @param value The value to coalesce.
+ */
+declare function coalesceToArray<T>(value?: T | T[]): T[] | undefined;
 
-export { ALIGNMENT, type Alignment, Alignments, type AlternateData, Alternates, Archetype, type ArchetypeData, BADGE_REQUIREMENT_TYPE, BADGE_TYPE, Badge, type BadgeData, BadgeIndex, BadgeRequirement, type BadgeRequirementData, type BadgeRequirementType, type BadgeSearchOptions, type BadgeType, BundleMetadata, CHANGELOG, type Change, CohContentDatabase, Contact, type ContactData, type ContentBundle, ENHANCEMENT_CATEGORY, type EnhancementCategory, Key, type Link, type MarkdownString, PLAQUE_TYPE, type Paged, type PlaqueType, SEX, type Sex, Zone, type ZoneData, badgeLink, badgeUri, contactLink, contactUri, zoneLink, zoneUri };
+export { ALIGNMENT, type Alignment, type AlignmentExtended, AlignmentList, type AlternateData, Alternates, Archetype, type ArchetypeData, BADGE_REQUIREMENT_TYPE, BADGE_TYPE, Badge, type BadgeData, BadgeIndex, BadgeRequirement, type BadgeRequirementData, type BadgeRequirementType, type BadgeSearchOptions, type BadgeType, BundleMetadata, CHANGELOG, type Change, CohContentDatabase, Contact, type ContactData, type ContentBundle, type Coords, ENHANCEMENT_CATEGORY, type EnhancementCategory, Key, type Link, Location, type LocationData, type LocationIcon, MISSION_TYPE, MORALITY, type MarkdownString, Mission, type MissionData, type MissionFlashbackData, type MissionType, type Morality, type MoralityExtended, MoralityList, type Paged, SEX, type Sex, Zone, type ZoneData, badgeLink, badgeUri, coalesceToArray, compareAlignment, compareByDefaultName, compareByZoneKey, compareSex, contactLink, contactUri, missionLink, missionUri, zoneLink, zoneUri };