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

package/dist/coh-content-db.mjs

@@ -1,9 +1,15 @@
 const ALIGNMENT = ["H", "V", "P"];
 
-const BADGE_PARTIAL_TYPE = [
+const BADGE_REQUIREMENT_TYPE = [
   "PLAQUE",
   "BADGE",
   "INVENTION",
+  "MISSION",
+  // Complete a mission
+  "ARC",
+  // Complete a story arc
+  "TASK_FORCE",
+  // Complete a task force
   "INVENTION_PLUS_ONE"
   // Some invention badges require you to build x of two different invention levels, 'plus one of either level'.
 ];
@@ -62,16 +68,16 @@ const PLAQUE_TYPE = [
 
 const SEX = ["M", "F"];
 
-var __defProp$8 = Object.defineProperty;
-var __defNormalProp$8 = (obj, key, value) => key in obj ? __defProp$8(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$8 = (obj, key, value) => __defNormalProp$8(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$7 = Object.defineProperty;
+var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$7 = (obj, key, value) => __defNormalProp$7(obj, typeof key !== "symbol" ? key + "" : key, value);
 class Alignments {
   constructor(raw) {
-    __publicField$8(this, "items");
-    __publicField$8(this, "hero");
-    __publicField$8(this, "villain");
-    __publicField$8(this, "praetorian");
-    __publicField$8(this, "primal");
+    __publicField$7(this, "items");
+    __publicField$7(this, "hero");
+    __publicField$7(this, "villain");
+    __publicField$7(this, "praetorian");
+    __publicField$7(this, "primal");
     this.items = raw;
     this.hero = raw.includes("H");
     this.villain = raw.includes("V");
@@ -181,198 +187,224 @@ validateKey_fn = function(key) {
   if (INVALID_KEY_PATTERN.test(key)) throw new Error(`Invalid key: [${key}]; Keys can only contain lowercase characters, numbers and dashes.`);
 };
 
-var __defProp$7 = Object.defineProperty;
-var __defNormalProp$7 = (obj, key, value) => key in obj ? __defProp$7(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$7 = (obj, key, value) => __defNormalProp$7(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$6 = Object.defineProperty;
+var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$6 = (obj, key, value) => __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
 class Archetype {
   constructor(data) {
-    __publicField$7(this, "key");
-    __publicField$7(this, "name");
-    __publicField$7(this, "description");
+    __publicField$6(this, "key");
+    __publicField$6(this, "name");
+    __publicField$6(this, "description");
     this.key = new Key(data.key).value;
     this.name = data.name;
     this.description = data.description;
   }
 }
 
-var __defProp$6 = Object.defineProperty;
-var __defNormalProp$6 = (obj, key, value) => key in obj ? __defProp$6(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$6 = (obj, key, value) => __defNormalProp$6(obj, typeof key !== "symbol" ? key + "" : key, value);
-class BadgePartial {
+var __defProp$5 = Object.defineProperty;
+var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$5 = (obj, key, value) => __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
+class BadgeRequirement {
   constructor(data) {
     /**
      * Key.
      */
-    __publicField$6(this, "key");
+    __publicField$5(this, "key");
     /**
-     * Type of partial.
+     * Type of requirement.
      */
-    __publicField$6(this, "type");
+    __publicField$5(this, "type");
     /**
-     * Map the partial is located on.
+     * Zone the requirement is located in.
      */
-    __publicField$6(this, "mapKey");
+    __publicField$5(this, "zoneKey");
     /**
      * /loc coordinates.
      */
-    __publicField$6(this, "loc");
+    __publicField$5(this, "loc");
     /**
      * Is it a wall plaque or a physical monument?
      */
-    __publicField$6(this, "plaqueType");
+    __publicField$5(this, "plaqueType");
     /**
      * Plaque inscription.
      */
-    __publicField$6(this, "plaqueInscription");
+    __publicField$5(this, "plaqueInscription");
+    /**
+     * The number or letter the plaque appears as on Vidiot Maps.
+     */
+    __publicField$5(this, "vidiotMapKey");
+    /**
+     * The key of the badge for this requirement.
+     */
+    __publicField$5(this, "badgeKey");
     /**
-     * The number or letter the partial appears as on Vidiot Maps.
+     * Mission name.
      */
-    __publicField$6(this, "vidiotMapKey");
+    __publicField$5(this, "missionName");
     /**
-     * The badge required for this partial.
+     * {@link Contact} key for the story arc.
      */
-    __publicField$6(this, "badgeKey");
+    __publicField$5(this, "contactKey");
     /**
      * Level of the invention required.
      */
-    __publicField$6(this, "inventionLevel");
+    __publicField$5(this, "inventionLevel");
     /**
      * The types of enhancements required to be crafted.
      */
-    __publicField$6(this, "inventionTypes");
+    __publicField$5(this, "inventionTypes");
     /**
      * Number of invention crafts required.
      */
-    __publicField$6(this, "inventionCount");
+    __publicField$5(this, "inventionCount");
     /**
      * Any additional notes.
      */
-    __publicField$6(this, "notes");
+    __publicField$5(this, "notes");
+    /**
+     * List of external links. Wiki, forums, etc.
+     */
+    __publicField$5(this, "links");
     this.key = new Key(data.key).value;
     this.type = data.type;
-    this.mapKey = data.mapKey;
+    this.zoneKey = data.zoneKey;
     this.loc = data.loc;
     this.plaqueType = data.plaqueType;
     this.plaqueInscription = data.plaqueInscription;
     this.vidiotMapKey = data.vidiotMapKey;
     this.badgeKey = data.badgeKey;
+    this.missionName = data.missionName;
+    this.contactKey = data.contactKey;
     this.inventionLevel = data.inventionLevel;
     this.inventionTypes = data.inventionTypes;
     this.inventionCount = data.inventionCount;
     this.notes = data.notes;
+    this.links = data.links ?? [];
   }
 }
 
-var __defProp$5 = Object.defineProperty;
+var __defProp$4 = Object.defineProperty;
 var __typeError$2 = (msg) => {
   throw TypeError(msg);
 };
-var __defNormalProp$5 = (obj, key, value) => key in obj ? __defProp$5(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$5 = (obj, key, value) => __defNormalProp$5(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$4 = (obj, key, value) => __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
 var __accessCheck$2 = (obj, member, msg) => member.has(obj) || __typeError$2("Cannot " + msg);
 var __privateGet$2 = (obj, member, getter) => (__accessCheck$2(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
 var __privateAdd$2 = (obj, member, value) => member.has(obj) ? __typeError$2("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
-var _partialsIndex;
+var _requirementsIndex;
 class Badge {
-  constructor(data) {
-    __privateAdd$2(this, _partialsIndex, {});
+  constructor(badgeData) {
+    __privateAdd$2(this, _requirementsIndex, {});
     /**
      * The database key for this badge.
      */
-    __publicField$5(this, "key");
+    __publicField$4(this, "key");
     /**
      * The type of badge.
      */
-    __publicField$5(this, "type");
+    __publicField$4(this, "type");
     /**
      * The name of this badge.
      *
      * May vary by character sex or alignment.
      */
-    __publicField$5(this, "name");
+    __publicField$4(this, "name");
     /**
      * The character alignments that this badge is available to.
      */
-    __publicField$5(this, "alignment");
+    __publicField$4(this, "alignment");
     /**
      * The badge text as it appears in-game. May vary by character sex or alignment.
      */
-    __publicField$5(this, "badgeText");
+    __publicField$4(this, "badgeText");
     /**
-     * Description of how to acquire the badge.
+     * Short description of how to acquire the badge. Detailed instructions will be in the notes field.
      */
-    __publicField$5(this, "acquisition");
+    __publicField$4(this, "acquisition");
     /**
      * Absolute URL to this badge's icon.
      *
      * May vary by character sex or alignment.
      */
-    __publicField$5(this, "icon");
+    __publicField$4(this, "icon");
     /**
      * Freeform notes or tips about the badge.
      */
-    __publicField$5(this, "notes");
+    __publicField$4(this, "notes");
     /**
-     * List of external links for this Badge. Wiki, forums, etc.
+     * List of external links. Wiki, forums, etc.
      */
-    __publicField$5(this, "links");
+    __publicField$4(this, "links");
     /**
-     * For exploration badges, the key of the {@link GameMap} that this badge is found on.
+     * For exploration badges, the key of the {@link Zone} that this badge is found on.
      */
-    __publicField$5(this, "mapKey");
+    __publicField$4(this, "zoneKey");
     /**
-     * For exploration badges, the `/loc` coordinates of the badge on the in-game map.
+     * For exploration badges, the `/loc` coordinates of the badge.
      */
-    __publicField$5(this, "loc");
+    __publicField$4(this, "loc");
     /**
-     * For badges that appear on a Vidiot Map, the number or letter the badge appears as.
+     * For plaques that appear on a Vidiot Map, the number or letter the badge appears as.
      */
-    __publicField$5(this, "vidiotMapKey");
+    __publicField$4(this, "vidiotMapKey");
     /**
      * ID used with the in-game `/settitle` command to apply the badge.
      */
-    __publicField$5(this, "setTitle");
+    __publicField$4(this, "setTitle");
     /**
      * A description of the effect the badge will have, such as a buff or granting a temporary power.
      */
-    __publicField$5(this, "effect");
+    __publicField$4(this, "effect");
     /**
-     * A list of requirements for badges that have partial fulfilment steps, such as visiting plaques for history badges, or collecting other badges for meta-badges like accolades.
+     * 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.
      */
-    __publicField$5(this, "partials");
+    __publicField$4(this, "requirements");
     /**
      * 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.
      */
-    __publicField$5(this, "ignoreInTotals");
-    this.key = new Key(data.key).value;
-    this.type = data.type;
-    this.name = new Alternates(data.name);
-    this.alignment = new Alignments(data.alignment);
-    this.badgeText = new Alternates(data.badgeText ?? []);
-    this.acquisition = data.acquisition;
-    this.icon = new Alternates(data.icon ?? []);
-    this.notes = data.notes;
-    this.links = data.links;
-    this.mapKey = data.mapKey;
-    this.loc = data.loc;
-    this.effect = data.effect;
-    this.vidiotMapKey = data.vidiotMapKey;
-    this.setTitle = data.setTitle;
-    this.ignoreInTotals = data.ignoreInTotals ?? false;
-    this.partials = data.partials?.map((data2) => {
-      if (__privateGet$2(this, _partialsIndex)[data2.key] !== void 0) throw new Error(`Duplicate badge partial key [${data2.key}]`);
-      const badge = new BadgePartial(data2);
-      __privateGet$2(this, _partialsIndex)[badge.key] = badge;
-      return badge;
+    __publicField$4(this, "ignoreInTotals");
+    this.key = new Key(badgeData.key).value;
+    this.type = badgeData.type;
+    this.name = new Alternates(badgeData.name);
+    this.alignment = new Alignments(badgeData.alignment);
+    this.badgeText = new Alternates(badgeData.badgeText ?? []);
+    this.acquisition = badgeData.acquisition;
+    this.icon = new Alternates(badgeData.icon ?? []);
+    this.notes = badgeData.notes;
+    this.links = badgeData.links ?? [];
+    this.zoneKey = badgeData.zoneKey;
+    this.loc = badgeData.loc;
+    this.effect = badgeData.effect;
+    this.vidiotMapKey = badgeData.vidiotMapKey;
+    this.setTitle = badgeData.setTitle;
+    this.ignoreInTotals = badgeData.ignoreInTotals ?? false;
+    this.requirements = badgeData.requirements?.map((groups, index) => {
+      const existingKeysInGroup = /* @__PURE__ */ new Set();
+      return groups.map((requirementData) => {
+        if (existingKeysInGroup.has(requirementData.key)) throw new Error(`Duplicate badge requirement key [${badgeData.key}:${requirementData.key}] in group [${index + 1}]`);
+        existingKeysInGroup.add(requirementData.key);
+        const badge = new BadgeRequirement(requirementData);
+        __privateGet$2(this, _requirementsIndex)[badge.key] = badge;
+        return badge;
+      });
     });
   }
-  getPartial(key) {
-    const result = __privateGet$2(this, _partialsIndex)[key];
-    if (result === void 0) throw new Error(`Unknown badge partial key [${key}]`);
+  getRequirement(key) {
+    const result = __privateGet$2(this, _requirementsIndex)[key];
+    if (result === void 0) throw new Error(`Unknown badge requirement key [${key}]`);
     return result;
   }
 }
-_partialsIndex = new WeakMap();
+_requirementsIndex = new WeakMap();
 
 var __typeError$1 = (msg) => {
   throw TypeError(msg);
@@ -382,15 +414,15 @@ var __privateGet$1 = (obj, member, getter) => (__accessCheck$1(obj, member, "rea
 var __privateAdd$1 = (obj, member, value) => member.has(obj) ? __typeError$1("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 var __privateSet$1 = (obj, member, value, setter) => (__accessCheck$1(obj, member, "write to private field"), member.set(obj, value), value);
 var __privateMethod = (obj, member, method) => (__accessCheck$1(obj, member, "access private method"), method);
-var _badges, _badgeIndex$1, _mapOrder, _BadgeIndex_instances, satisfiesQueryPredicate_fn, satisfiesFilterPredicate_fn, sort_fn;
+var _badges, _badgeIndex$1, _zoneOrder, _BadgeIndex_instances, satisfiesQueryPredicate_fn, satisfiesFilterPredicate_fn, sort_fn;
 class BadgeIndex {
-  constructor(badges, maps) {
+  constructor(badges, zones) {
     __privateAdd$1(this, _BadgeIndex_instances);
     __privateAdd$1(this, _badges, []);
     __privateAdd$1(this, _badgeIndex$1, {});
-    __privateAdd$1(this, _mapOrder, {});
-    __privateSet$1(this, _mapOrder, Object.fromEntries(
-      maps?.sort((a, b) => a.name.localeCompare(b.name))?.map((x, index) => [x.key, index]) ?? []
+    __privateAdd$1(this, _zoneOrder, {});
+    __privateSet$1(this, _zoneOrder, Object.fromEntries(
+      zones?.sort((a, b) => a.name.localeCompare(b.name))?.map((x, index) => [x.key, index]) ?? []
     ));
     __privateSet$1(this, _badges, badges);
     for (const badge of badges) {
@@ -403,29 +435,34 @@ class BadgeIndex {
     if (result === void 0) throw new Error(`Unknown badge key [${key}]`);
     return result;
   }
+  badgeExists(key) {
+    return !!__privateGet$1(this, _badgeIndex$1)[key];
+  }
   searchBadges(options) {
     const filtered = options?.query || options?.filter ? __privateGet$1(this, _badges).filter((badge) => __privateMethod(this, _BadgeIndex_instances, satisfiesQueryPredicate_fn).call(this, badge, options?.query) && __privateMethod(this, _BadgeIndex_instances, satisfiesFilterPredicate_fn).call(this, badge, options?.filter)) : __privateGet$1(this, _badges);
-    const paged = options?.pageSize ? filtered.slice(((options?.page ?? 1) - 1) * options.pageSize, (options?.page ?? 1) * options?.pageSize) : filtered;
+    const totalPages = options?.pageSize ? Math.ceil(filtered.length / options?.pageSize) : 1;
+    const page = Math.max(1, Math.min(totalPages, options?.page ?? 1));
+    const paged = options?.pageSize ? filtered.slice((page - 1) * options.pageSize, page * options?.pageSize) : filtered;
     const sorted = __privateMethod(this, _BadgeIndex_instances, sort_fn).call(this, paged, options?.sort);
     return {
       items: sorted,
-      page: options?.page ?? 1,
+      page,
       pageSize: options?.pageSize,
       totalItems: filtered.length,
-      totalPages: options?.pageSize ? Math.ceil(filtered.length / options?.pageSize) : 1
+      totalPages
     };
   }
 }
 _badges = new WeakMap();
 _badgeIndex$1 = new WeakMap();
-_mapOrder = new WeakMap();
+_zoneOrder = new WeakMap();
 _BadgeIndex_instances = new WeakSet();
 satisfiesQueryPredicate_fn = function(badge, query) {
   const queryString = query?.str?.toLowerCase() ?? "";
   return !!((query?.on?.name ?? true) && badge.name.canonical.some((x) => x.value.toLowerCase().includes(queryString)) || query?.on?.badgeText && badge.badgeText.canonical.some((x) => x.value.toLowerCase().includes(queryString)) || query?.on?.acquisition && badge.acquisition?.toLowerCase().includes(queryString) || query?.on?.effect && badge.effect?.toLowerCase().includes(queryString) || query?.on?.notes && badge.notes?.toLowerCase().includes(queryString) || query?.on?.setTitle && (badge.setTitle?.id?.toString().includes(queryString) || badge.setTitle?.praetorianId?.toString().includes(queryString)));
 };
 satisfiesFilterPredicate_fn = function(badge, filter) {
-  return (!filter?.type || badge.type === filter.type) && (!filter?.mapKey || badge.mapKey === filter.mapKey) && (!filter?.alignment || badge.alignment.items.includes(filter.alignment));
+  return (!filter?.type || badge.type === filter.type) && (!filter?.zoneKey || badge.zoneKey === filter.zoneKey) && (!filter?.alignment || badge.alignment.items.includes(filter.alignment));
 };
 sort_fn = function(badges, sort) {
   if (!sort) return badges;
@@ -433,8 +470,8 @@ sort_fn = function(badges, sort) {
   if (!sort.by || sort.by === "CANONICAL") return sort.dir === "DESC" ? badges.reverse() : badges;
   if (sort.by === "BADGE_NAME") return ascending ? badges.sort((a, b) => a.name.default?.value.localeCompare(b.name.default?.value ?? "") ?? 0) : badges.sort((a, b) => b.name.default?.value.localeCompare(a.name.default?.value ?? "") ?? 0);
   return badges.sort((a, b) => {
-    const aIndex = __privateGet$1(this, _mapOrder)[a.mapKey ?? ""];
-    const bIndex = __privateGet$1(this, _mapOrder)[b.mapKey ?? ""];
+    const aIndex = __privateGet$1(this, _zoneOrder)[a.zoneKey ?? ""];
+    const bIndex = __privateGet$1(this, _zoneOrder)[b.zoneKey ?? ""];
     if (aIndex === bIndex) return 0;
     if (aIndex === void 0) return ascending ? 1 : -1;
     if (bIndex === void 0) return ascending ? -1 : 1;
@@ -442,31 +479,31 @@ sort_fn = function(badges, sort) {
   });
 };
 
-var __defProp$4 = Object.defineProperty;
-var __defNormalProp$4 = (obj, key, value) => key in obj ? __defProp$4(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$4 = (obj, key, value) => __defNormalProp$4(obj, typeof key !== "symbol" ? key + "" : key, value);
+var __defProp$3 = Object.defineProperty;
+var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
 class BundleMetadata {
   constructor(bundle) {
     /**
-     * Name of the server group.
+     * Name of the content bundle.
      */
-    __publicField$4(this, "name");
+    __publicField$3(this, "name");
     /**
-     * Description of the server group.
+     * Description of the fork.
      */
-    __publicField$4(this, "description");
+    __publicField$3(this, "description");
     /**
      * Repository where the db content package is maintained.
      */
-    __publicField$4(this, "repository");
+    __publicField$3(this, "repository");
     /**
-     * List of external links for this Server Group. Wiki, forums, etc.
+     * List of external links. Wiki, forums, etc.
      */
-    __publicField$4(this, "links");
+    __publicField$3(this, "links");
     /**
      * Change log for this data package.
      */
-    __publicField$4(this, "changelog");
+    __publicField$3(this, "changelog");
     this.name = bundle.name;
     this.description = bundle.description;
     this.repository = bundle.repository;
@@ -475,89 +512,78 @@ class BundleMetadata {
   }
 }
 
-var __defProp$3 = Object.defineProperty;
-var __defNormalProp$3 = (obj, key, value) => key in obj ? __defProp$3(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
-var __publicField$3 = (obj, key, value) => __defNormalProp$3(obj, typeof key !== "symbol" ? key + "" : key, value);
-class VidiotMapPointOfInterest {
-  constructor(data) {
-    /**
-     * The pixel-space position of the PoI on the map graphic.
-     *
-     * Screen-space, pixels from top-left `[0, 0]`.
-     */
-    __publicField$3(this, "pos");
-    /**
-     * Freeform notes about the PoI.
-     */
-    __publicField$3(this, "notes");
-    /**
-     * If the POI is a zone transfer, the map it transfers to.
-     */
-    __publicField$3(this, "mapKey");
-    /**
-     * If the POI is a badge, the badge.
-     */
-    __publicField$3(this, "badgeKey");
-    /**
-     * If the POI is a partial for a badge, the partial key.
-     */
-    __publicField$3(this, "badgePartialKey");
-    this.pos = data.pos;
-    this.notes = data.notes;
-    this.mapKey = data.mapKey;
-    this.badgeKey = data.badgeKey;
-    this.badgePartialKey = data.badgePartialKey;
-  }
-}
-
 var __defProp$2 = Object.defineProperty;
 var __defNormalProp$2 = (obj, key, value) => key in obj ? __defProp$2(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField$2 = (obj, key, value) => __defNormalProp$2(obj, typeof key !== "symbol" ? key + "" : key, value);
-class VidiotMap {
+class Zone {
   constructor(data) {
     /**
-     * URL of the map image.
+     * Unique key used to reference this zone.
+     *
+     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
      */
-    __publicField$2(this, "imageUrl");
+    __publicField$2(this, "key");
     /**
-     * Name to display for the Vidiot map.
+     * The name of the zone as it appears in-game.
      */
     __publicField$2(this, "name");
     /**
-     * List of Points of Interest labelled on the image.
+     * List of external links. Wiki, forums, etc.
      */
-    __publicField$2(this, "pointsOfInterest");
-    this.imageUrl = data.imageUrl;
+    __publicField$2(this, "links");
+    this.key = new Key(data.key).value;
     this.name = data.name;
-    this.pointsOfInterest = data.pointsOfInterest?.map((data2) => new VidiotMapPointOfInterest(data2));
+    this.links = data.links ?? [];
   }
 }
 
 var __defProp$1 = Object.defineProperty;
 var __defNormalProp$1 = (obj, key, value) => key in obj ? __defProp$1(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField$1 = (obj, key, value) => __defNormalProp$1(obj, typeof key !== "symbol" ? key + "" : key, value);
-class GameMap {
-  constructor(data) {
+class Contact {
+  constructor(contactData) {
     /**
-     * The database key for this map.
+     * Unique key used to reference this contact.
+     *
+     * Keys can only contain lowercase letters, numbers and hyphens (`-`).
      */
     __publicField$1(this, "key");
     /**
-     * The name of the map as it appears in-game.
+     * The name of this contact.
      */
     __publicField$1(this, "name");
     /**
-     * List of external links for this Map. Wiki, forums, etc.
+     * The contact's title.
      */
-    __publicField$1(this, "links");
+    __publicField$1(this, "title");
     /**
-     * List of Vidiot Map assets for this map.
+     * The zone this character is located in.
      */
-    __publicField$1(this, "vidiotMaps");
-    this.key = new Key(data.key).value;
-    this.name = data.name;
-    this.links = data.links;
-    this.vidiotMaps = data.vidiotMaps?.map((data2) => new VidiotMap(data2));
+    __publicField$1(this, "zoneKey");
+    /**
+     * The `/loc` coordinates of the contact.
+     */
+    __publicField$1(this, "loc");
+    /**
+     * The level range this contact will offer missions for.
+     */
+    __publicField$1(this, "levelRange");
+    /**
+     * Freeform notes or tips about the contact.
+     */
+    __publicField$1(this, "notes");
+    /**
+     * List of external links. Wiki, forums, etc.
+     */
+    __publicField$1(this, "links");
+    this.key = new Key(contactData.key).value;
+    this.name = contactData.name;
+    this.title = contactData.title;
+    this.zoneKey = contactData.zoneKey;
+    this.loc = contactData.loc;
+    this.levelRange = contactData.levelRange;
+    this.notes = contactData.notes;
+    this.links = contactData.links ?? [];
   }
 }
 
@@ -571,7 +597,7 @@ var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot
 var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
 var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), member.set(obj, value), value);
-var _archetypeIndex, _mapIndex, _badgeIndex;
+var _archetypeIndex, _zoneIndex, _contactIndex, _badgeIndex;
 class CohContentDatabase {
   /**
    * Initialize the database with a content bundle.
@@ -579,59 +605,85 @@ class CohContentDatabase {
    */
   constructor(bundle) {
     __privateAdd(this, _archetypeIndex, {});
-    __privateAdd(this, _mapIndex, {});
+    __privateAdd(this, _zoneIndex, {});
+    __privateAdd(this, _contactIndex, {});
     __privateAdd(this, _badgeIndex);
     /**
      * Metadata about the content bundle.
      */
     __publicField(this, "metadata");
     /**
-     * List of the game server names in this server group.
+     * List of the game server names.
+     *
      * Torchbearer, Excelsior, etc.
      */
     __publicField(this, "servers");
     /**
-     * List of archetypes available in this server group.
+     * List of archetypes.
      */
     __publicField(this, "archetypes");
     /**
-     * List of game maps supported by this server group.
+     * List of game zones.
+     */
+    __publicField(this, "zones");
+    /**
+     * List of contacts.
      */
-    __publicField(this, "maps");
+    __publicField(this, "contacts");
     /**
-     * List of badges available on this server group.
+     * List of badges.
      */
     __publicField(this, "badges");
     this.metadata = new BundleMetadata(bundle);
     this.servers = bundle.servers ?? [];
     this.archetypes = bundle.archetypes?.map((data) => {
-      if (__privateGet(this, _archetypeIndex)[data.key] !== void 0) throw new Error(`Duplicate archetype key [${data.key}]`);
+      if (__privateGet(this, _archetypeIndex)[data.key] !== void 0) throw new Error(`Duplicate archetype key '${data.key}'`);
       const archetype = new Archetype(data);
       __privateGet(this, _archetypeIndex)[archetype.key] = archetype;
       return archetype;
     }) ?? [];
-    this.maps = bundle.maps?.map((data) => {
-      if (__privateGet(this, _mapIndex)[data.key] !== void 0) throw new Error(`Duplicate map key [${data.key}]`);
-      const map = new GameMap(data);
-      __privateGet(this, _mapIndex)[map.key] = map;
-      return map;
+    this.zones = bundle.zones?.map((data) => {
+      if (__privateGet(this, _zoneIndex)[data.key] !== void 0) throw new Error(`Duplicate zone key '${data.key}'`);
+      const zone = new Zone(data);
+      __privateGet(this, _zoneIndex)[zone.key] = zone;
+      return zone;
+    }) ?? [];
+    this.contacts = bundle.contacts?.map((data) => {
+      if (__privateGet(this, _contactIndex)[data.key] !== void 0) throw new Error(`Duplicate contact key '${data.key}'`);
+      const contact = new Contact(data);
+      __privateGet(this, _contactIndex)[contact.key] = contact;
+      return contact;
     }) ?? [];
     this.badges = bundle.badges?.map((data) => new Badge(data)) ?? [];
-    __privateSet(this, _badgeIndex, new BadgeIndex(this.badges, this.maps));
+    __privateSet(this, _badgeIndex, new BadgeIndex(this.badges, this.zones));
   }
   getArchetype(key) {
     const result = __privateGet(this, _archetypeIndex)[key];
-    if (result === void 0) throw new Error(`Unknown archetype key [${key}]`);
+    if (result === void 0) throw new Error(`Unknown archetype key '${key}'`);
     return result;
   }
-  getMap(key) {
-    const result = __privateGet(this, _mapIndex)[key];
-    if (result === void 0) throw new Error(`Unknown map key [${key}]`);
+  getZone(key) {
+    const result = __privateGet(this, _zoneIndex)[key];
+    if (result === void 0) throw new Error(`Unknown zone key '${key}'`);
     return result;
   }
+  getContact(key) {
+    const result = __privateGet(this, _contactIndex)[key];
+    if (result === void 0) throw new Error(`Unknown contact key '${key}'`);
+    return result;
+  }
+  zoneExists(key) {
+    return !!__privateGet(this, _zoneIndex)[key];
+  }
+  contactExists(key) {
+    return !!__privateGet(this, _contactIndex)[key];
+  }
   getBadge(key) {
     return __privateGet(this, _badgeIndex).getBadge(key);
   }
+  badgeExists(key) {
+    return __privateGet(this, _badgeIndex).badgeExists(key);
+  }
   /**
    * 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
@@ -643,7 +695,8 @@ class CohContentDatabase {
   }
 }
 _archetypeIndex = new WeakMap();
-_mapIndex = new WeakMap();
+_zoneIndex = new WeakMap();
+_contactIndex = new WeakMap();
 _badgeIndex = new WeakMap();
 
 const CHANGELOG = [
@@ -654,9 +707,13 @@ const CHANGELOG = [
 * Server groups are now referred to as 'forks'.
 * Replaced enums with union types.
 * \`IServerGroupData\` is now \`ContentBundle\` and each database instance is now designed to accept only a single server group.
+* \`GameMap\` is now \`Zone\`.
 * Removed the \`serverGroup\` property from entities to simplify the object tree given that only a single context can exist per db now.
 * Added a simple indexing and search function for badge names, text and acquisition info.
-* Map and badge references now follow a standard Markdown link format with a \`badge://\` or \`map://\` protocol.
+* Zone and badge references now follow a standard Markdown link format with a \`badge://\` or \`map://\` protocol.
+* Badge partials are now known as badge requirements and support both AND and OR groups of requirements.
+* Removed the \`VidiotMap\` API as it was never used or fleshed out properly.
+* Added support for story arcs to badge requirements including a link to the contact.
 * Standardized pluralization of some field names (name, icon).
 * Combined \`settitle\` ids into a single tuple field.
 * Change from GNU to The Unlicense.
@@ -677,14 +734,22 @@ function badgeLink(target) {
   const key = typeof target === "string" ? target : target.key;
   return `[${key}](${badgeUri(target)})`;
 }
-function mapUri(target) {
+function contactUri(target) {
+  const key = typeof target === "string" ? target : target.key;
+  return `contact://${key}`;
+}
+function contactLink(target) {
+  const key = typeof target === "string" ? target : target.key;
+  return `[${key}](${contactUri(target)})`;
+}
+function zoneUri(target) {
   const key = typeof target === "string" ? target : target.key;
-  return `map://${key}`;
+  return `zone://${key}`;
 }
-function mapLink(target) {
+function zoneLink(target) {
   const key = typeof target === "string" ? target : target.key;
-  return `[${key}](${mapUri(target)})`;
+  return `[${key}](${zoneUri(target)})`;
 }
 
-export { ALIGNMENT, Alignments, Alternates, Archetype, BADGE_PARTIAL_TYPE, BADGE_TYPE, Badge, BadgeIndex, BadgePartial, BundleMetadata, CHANGELOG, CohContentDatabase, ENHANCEMENT_CATEGORY, GameMap, Key, PLAQUE_TYPE, SEX, VidiotMap, VidiotMapPointOfInterest, badgeLink, badgeUri, mapLink, mapUri };
+export { ALIGNMENT, Alignments, Alternates, Archetype, BADGE_REQUIREMENT_TYPE, BADGE_TYPE, Badge, BadgeIndex, BadgeRequirement, BundleMetadata, CHANGELOG, CohContentDatabase, Contact, ENHANCEMENT_CATEGORY, Key, PLAQUE_TYPE, SEX, Zone, badgeLink, badgeUri, contactLink, contactUri, zoneLink, zoneUri };
 //# sourceMappingURL=coh-content-db.mjs.map