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

package/src/main/db/mission.ts

@@ -0,0 +1,107 @@
+import { MissionType } from '../api/mission-type'
+import { MarkdownString } from '../api/markdown-string'
+import { Link } from '../api/link'
+import { MissionData } from '../api/mission-data'
+import { Key } from './key'
+import { coalesceToArray } from '../util'
+import { MoralityList } from './morality-list'
+
+export 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) {
+    this.key = new Key(data.key).value
+    this.name = data.name
+    this.type = data.type
+    this.morality = new MoralityList(coalesceToArray(data.morality))
+    this.contactKeys = coalesceToArray(data.contactKeys)
+    this.levelRange = data.levelRange
+    this.notes = data.notes
+    this.links = data.links ?? []
+    this.flashback = createFlashback(data)
+  }
+}
+
+function createFlashback(data: MissionData): Mission['flashback'] {
+  if (!data.flashback) return undefined
+  return {
+    id: data.flashback.id,
+    levelRange: data.flashback.levelRange ?? data.levelRange,
+    name: data.flashback.name ?? data.name,
+    morality: new MoralityList(coalesceToArray(data.flashback.morality ?? data.morality)),
+    notes: data.flashback.notes,
+  }
+}

package/src/main/db/morality-list.ts

@@ -0,0 +1,99 @@
+import { MORALITY, Morality, MoralityExtended } from '../api/morality'
+
+export class MoralityList {
+  readonly #items: Set<Morality>
+
+  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[]) {
+    const set = new Set(items ?? [...MORALITY])
+    this.hero = set.has('hero') || set.has('primal') || set.has('heroic') || set.has('paragon-city-access') || set.has('all')
+    this.vigilante = set.has('vigilante') || set.has('primal') || set.has('heroic') || set.has('paragon-city-access') || set.has('rogue-isles-access') || set.has('all')
+    this.villain = set.has('villain') || set.has('primal') || set.has('villainous') || set.has('rogue-isles-access') || set.has('all')
+    this.rogue = set.has('rogue') || set.has('primal') || set.has('villainous') || set.has('paragon-city-access') || set.has('rogue-isles-access') || set.has('all')
+    this.resistance = set.has('resistance') || set.has('praetorian') || set.has('all')
+    this.loyalist = set.has('loyalist') || set.has('praetorian') || set.has('all')
+
+    this.primal = this.hero && this.vigilante && this.villain && this.rogue
+    this.praetorian = this.loyalist && this.resistance
+    this.heroic = this.hero && this.vigilante
+    this.villainous = this.villain && this.rogue
+    this.paragonCityAccess = this.heroic && this.rogue
+    this.rogueIslesAccess = this.villainous && this.vigilante
+
+    this.all = this.primal && this.praetorian
+
+    this.#items = new Set()
+    if (this.hero) this.#items.add('hero')
+    if (this.vigilante) this.#items.add('vigilante')
+    if (this.villain) this.#items.add('villain')
+    if (this.rogue) this.#items.add('rogue')
+    if (this.resistance) this.#items.add('resistance')
+    if (this.loyalist) this.#items.add('loyalist')
+  }
+
+  get items(): Morality[] {
+    return [...this.#items]
+  }
+
+  has(morality?: MoralityExtended): boolean {
+    switch (morality) {
+      case 'hero': {
+        return this.hero
+      }
+      case 'vigilante': {
+        return this.vigilante
+      }
+      case 'villain': {
+        return this.villain
+      }
+      case 'rogue': {
+        return this.rogue
+      }
+      case 'resistance': {
+        return this.resistance
+      }
+      case 'loyalist': {
+        return this.loyalist
+      }
+      case 'primal' : {
+        return this.primal
+      }
+      case 'praetorian': {
+        return this.praetorian
+      }
+      case 'heroic': {
+        return this.hero
+      }
+      case 'paragon-city-access': {
+        return this.paragonCityAccess
+      }
+      case 'rogue-isles-access': {
+        return this.rogueIslesAccess
+      }
+      case 'villainous': {
+        return this.villainous
+      }
+      case 'all': {
+        return this.all
+      }
+      default: {
+        return false
+      }
+    }
+  }
+}

package/src/main/db/zone.ts

@@ -6,7 +6,7 @@ export class Zone {
   /**
    * 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
 

package/src/main/index.ts

@@ -11,13 +11,16 @@ export * from './api/contact-data'
 export * from './api/content-bundle'
 export * from './api/enhancement-category'
 export * from './api/link'
+export * from './api/location-data'
 export * from './api/markdown-string'
-export * from './api/plaque-type'
+export * from './api/mission-data'
+export * from './api/mission-type'
+export * from './api/morality'
 export * from './api/sex'
 export * from './api/zone-data'
 
 // DB
-export * from './db/alignments'
+export * from './db/alignment-list'
 export * from './db/alternates'
 export * from './db/archetype'
 export * from './db/badge'
@@ -28,10 +31,12 @@ export * from './db/bundle-metadata'
 export * from './db/coh-content-database'
 export * from './db/contact'
 export * from './db/key'
+export * from './db/location'
+export * from './db/mission'
+export * from './db/morality-list'
 export * from './db/paged'
 export * from './db/zone'
 
 // ROOT
 export { CHANGELOG } from './changelog'
-
 export * from './util'

package/src/main/util.ts

@@ -4,9 +4,11 @@ import { ZoneData } from './api/zone-data'
 import { Zone } from './db/zone'
 import { Contact } from './db/contact'
 import { ContactData } from './api/contact-data'
+import { Mission } from './db/mission'
+import { MissionData } from './api/mission-data'
 
 /**
- * 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>`
  *
@@ -30,7 +32,7 @@ export 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>`
  *
@@ -54,7 +56,31 @@ export 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.
+ */
+export function missionUri(target: string | Mission | MissionData): string {
+  const key = typeof target === 'string' ? target : target.key
+  return `mission://${key}`
+}
+
+/**
+ * Returns a {@link MarkdownString} link to the given mission.
+ *
+ * Link format: `[<key>](mission://<key>)`
+ *
+ * @param target The {@link Mission} or mission key to target.
+ */
+export function missionLink(target: string | Mission | MissionData): string {
+  const key = typeof target === 'string' ? target : target.key
+  return `[${key}](${missionUri(target)})`
+}
+
+/**
+ * Returns the URI of the given zone that can be used in {@link MarkdownString} fields.
  *
  * URI format: `zone://<key>`
  *
@@ -76,3 +102,17 @@ export function zoneLink(target: string | Zone | ZoneData): string {
   const key = typeof target === 'string' ? target : target.key
   return `[${key}](${zoneUri(target)})`
 }
+
+/**
+ * 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.
+ */
+export function coalesceToArray<T>(value?: T | T[]): T[] | undefined {
+  if (!value) return undefined
+  return Array.isArray(value) ? value as T[] : [value]
+}

package/src/test/api/alignment.test.ts

@@ -1,4 +1,4 @@
-import { Alignment, ALIGNMENT } from '../../main'
+import { Alignment, ALIGNMENT, compareAlignment } from '../../main'
 
 describe('ALIGNMENT', () => {
   test('should be an array', () => {
@@ -16,7 +16,7 @@ describe('ALIGNMENT', () => {
   })
 
   test('should contain all known alignments', () => {
-    const expected = ['H', 'V', 'P']
+    const expected = ['hero', 'villain', 'praetorian']
     for (const category of expected) {
       expect(ALIGNMENT).toContain(category)
     }
@@ -25,7 +25,41 @@ describe('ALIGNMENT', () => {
 
 describe('Alignment', () => {
   test('should be a usable type', () => {
-    const field: Alignment = 'H'
-    expect(field).toBe('H')
+    const field: Alignment = 'hero'
+    expect(field).toBe('hero')
+  })
+})
+
+describe('compareAlignment', () => {
+  test('should return <0 if first argument comes first', () => {
+    expect(compareAlignment('hero', 'villain')).toBeLessThan(0)
+    expect(compareAlignment('hero', 'praetorian')).toBeLessThan(0)
+  })
+
+  test('should return >0 if second argument comes first', () => {
+    expect(compareAlignment('villain', 'hero')).toBeGreaterThan(0)
+    expect(compareAlignment('praetorian', 'hero')).toBeGreaterThan(0)
+  })
+
+  test('should return 0 if arguments match', () => {
+    expect(compareAlignment('hero', 'hero')).toBe(0)
+  })
+
+  test('should return 0 if both arguments are undefined', () => {
+    expect(compareAlignment()).toBe(0)
+  })
+
+  test('should work as a compare function', () => {
+    const unsorted: (Alignment | undefined)[] = [undefined, 'hero', 'villain', 'praetorian', undefined, 'villain', 'praetorian']
+    const sorted = unsorted.sort(compareAlignment)
+
+    expect(sorted).toStrictEqual(['hero', 'villain', 'villain', 'praetorian', 'praetorian', undefined, undefined])
+  })
+
+  test('should sort against undefined', () => {
+    const unsorted: (Alignment | undefined)[] = [undefined, 'hero']
+    const sorted = unsorted.sort(compareAlignment)
+
+    expect(sorted).toStrictEqual(['hero', undefined])
   })
 })

package/src/test/api/badge-data.fixture.ts

@@ -1,24 +1,8 @@
 import { defineFixture } from 'efate'
-import { ALIGNMENT, BADGE_TYPE, BadgeData } from '../../main'
-import { badgeRequirementDataFixture } from './badge-requirement-data.fixture'
+import { BADGE_TYPE, BadgeData } from '../../main'
 
 export const badgeDataFixture = defineFixture<BadgeData>((t) => {
   t.key.as(index => `badge-${index}`)
   t.type.pickFrom([...BADGE_TYPE])
   t.name.as(index => [{ value: `Badge ${index}` }])
-  t.alignment.pickFrom([...ALIGNMENT])
-  t.badgeText?.as(index => [{ value: `This is badge ${index}` }])
-  t.acquisition?.asLoremIpsum()
-  t.icon?.as(() => [{ value: 'https://nouri.org' }])
-  t.notes?.asLoremIpsum()
-  t.links?.as(() => [{ href: 'https://nouri.org' }])
-  t.zoneKey?.asString()
-  t.loc?.as(index => [index, index, index])
-  t.vidiotMapKey?.asString()
-  t.setTitle?.as((index) => {
-    return { id: index }
-  })
-  t.effect?.asString()
-  t.requirements?.as(() => [[badgeRequirementDataFixture]])
-  t.ignoreInTotals?.asBoolean()
 })

package/src/test/api/badge-data.test.ts

@@ -3,9 +3,9 @@ import { BadgeData } from '../../main'
 // If you change this test, update the example in the README as well
 export const TEST_BADGE: BadgeData = {
   key: 'test-badge',
-  type: 'ACHIEVEMENT',
-  name: [{ value: 'Test Badge' }, { alignment: 'P', value: 'My Badge for Praetorians' }],
-  alignment: ['H', 'V', 'P'],
+  type: 'achievement',
+  name: [{ value: 'Test Badge' }, { alignment: 'praetorian', value: 'My Badge for Praetorians' }],
+  morality: ['hero', 'praetorian'],
 }
 
 describe('BadgeData', () => {

package/src/test/api/badge-requirement-data.fixture.ts

@@ -1,17 +1,7 @@
 import { defineFixture } from 'efate'
-import { BADGE_REQUIREMENT_TYPE, BadgeRequirementData, ENHANCEMENT_CATEGORY, PLAQUE_TYPE } from '../../main'
+import { BADGE_REQUIREMENT_TYPE, BadgeRequirementData } from '../../main'
 
 export const badgeRequirementDataFixture = defineFixture<BadgeRequirementData>((t) => {
   t.key.as(index => `badge-requirement-${index}`)
   t.type.pickFrom([...BADGE_REQUIREMENT_TYPE])
-  t.zoneKey?.asString()
-  t.loc?.as(index => [index, index, index])
-  t.plaqueType?.pickFrom([...PLAQUE_TYPE])
-  t.plaqueInscription?.asLoremIpsum()
-  t.vidiotMapKey?.asString()
-  t.badgeKey?.as(index => `badge-${index}`)
-  t.inventionLevel?.asNumber()
-  t.inventionTypes?.pickFrom([...ENHANCEMENT_CATEGORY])
-  t.inventionCount?.asNumber()
-  t.notes?.asLoremIpsum()
 })

package/src/test/api/badge-requirement-type.test.ts

@@ -16,7 +16,7 @@ describe('BADGE_REQUIREMENT_TYPE', () => {
   })
 
   test('should contain all known badge requirement types', () => {
-    const expected = ['PLAQUE', 'BADGE', 'INVENTION', 'INVENTION_PLUS_ONE']
+    const expected = ['badge', 'invention', 'invention-plus-one', 'location', 'monument', 'mission', 'task']
     for (const category of expected) {
       expect(BADGE_REQUIREMENT_TYPE).toContain(category)
     }
@@ -25,7 +25,7 @@ describe('BADGE_REQUIREMENT_TYPE', () => {
 
 describe('BadgeRequirementType', () => {
   test('should be a usable type', () => {
-    const field: BadgeRequirementType = 'PLAQUE'
-    expect(field).toBe('PLAQUE')
+    const field: BadgeRequirementType = 'monument'
+    expect(field).toBe('monument')
   })
 })

package/src/test/api/badge-type.test.ts

@@ -17,9 +17,9 @@ describe('BADGE_TYPE', () => {
 
   test('should contain all known basic badge types', () => {
     const expected = [
-      'EXPLORATION', 'HISTORY', 'ACCOMPLISHMENT', 'ACHIEVEMENT', 'ACCOLADE',
-      'GLADIATOR', 'VETERAN', 'PVP', 'INVENTION', 'DEFEAT',
-      'EVENT', 'OUROBOROS', 'CONSIGNMENT', 'DAY_JOB', 'AE',
+      'exploration', 'history', 'accomplishment', 'achievement', 'accolade',
+      'gladiator', 'veteran', 'pvp', 'invention', 'defeat',
+      'event', 'ouroboros', 'consignment', 'day-job', 'architect-entertainment',
     ]
     for (const category of expected) {
       expect(BADGE_TYPE).toContain(category)
@@ -29,7 +29,7 @@ describe('BADGE_TYPE', () => {
 
 describe('BadgeType', () => {
   test('should be a usable type', () => {
-    const field: BadgeType = 'EXPLORATION'
-    expect(field).toBe('EXPLORATION')
+    const field: BadgeType = 'exploration'
+    expect(field).toBe('exploration')
   })
 })

package/src/test/api/contact-data.fixture.ts

@@ -4,10 +4,4 @@ import { ContactData } from '../../main'
 export const contactDataFixture = defineFixture<ContactData>((t) => {
   t.key.as(index => `contact-${index}`)
   t.name.as(index => [{ value: `Contact ${index}` }])
-  t.title?.as(index => [{ value: `Contact title ${index}` }])
-  t.zoneKey?.asString()
-  t.loc?.as(index => [index, index, index])
-  t.levelRange?.as(index => [index, index])
-  t.notes?.asLoremIpsum()
-  t.links?.as(() => [{ href: 'https://nouri.org' }])
 })

package/src/test/api/content-bundle.fixture.ts

@@ -1,22 +1,6 @@
 import { defineFixture } from 'efate'
-import { Change, ContentBundle } from '../../main'
-import { archetypeDataFixture } from './archetype-data.fixture'
-import { zoneDataFixture } from './zone-data.fixture'
-import { badgeDataFixture } from './badge-data.fixture'
+import { ContentBundle } from '../../main'
 
 export const contentBundleFixture = defineFixture<ContentBundle>((t) => {
   t.name.as(index => `Bundle ${index}`)
-  t.description?.asLoremIpsum()
-  t.repository?.as(index => `https://nouri.org?id=${index}`)
-  t.servers?.asArray()
-  t.archetypes?.arrayOfFixture({ fixture: archetypeDataFixture })
-  t.zones?.arrayOfFixture({ fixture: zoneDataFixture })
-  t.badges?.arrayOfFixture({ fixture: badgeDataFixture })
-  t.changelog?.arrayOfFixture({
-    fixture: defineFixture<Change>((t) => {
-      t.version.as(index => `${index}`)
-      t.date.as(() => new Date())
-      t.description?.asLoremIpsum()
-    }),
-  })
 })

package/src/test/api/enhancement-category.test.ts

@@ -17,9 +17,9 @@ describe('ENHANCEMENT_CATEGORY', () => {
 
   test('should contain all known default enhancement categories', () => {
     const expected = [
-      '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',
+      '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',
     ]
     for (const category of expected) {
       expect(ENHANCEMENT_CATEGORY).toContain(category)
@@ -29,7 +29,7 @@ describe('ENHANCEMENT_CATEGORY', () => {
 
 describe('EnhancementCategory', () => {
   test('should be a usable type', () => {
-    const field: EnhancementCategory = 'RUN_SPEED'
-    expect(field).toBe('RUN_SPEED')
+    const field: EnhancementCategory = 'run-speed'
+    expect(field).toBe('run-speed')
   })
 })

package/src/test/api/mission-data.fixture.ts

@@ -0,0 +1,12 @@
+import { defineFixture } from 'efate'
+import { MISSION_TYPE, MissionData, MissionFlashbackData } from '../../main'
+
+export const missionDataFixture = defineFixture<MissionData>((t) => {
+  t.key.as(index => `mission-${index}`)
+  t.name.as(index => `Mission ${index}`)
+  t.type.pickFrom([...MISSION_TYPE])
+})
+
+export const missionFlashbackDataFixture = defineFixture<MissionFlashbackData>((t) => {
+  t.id.as(index => `${index}.${index}`)
+})

package/src/test/api/sex.test.ts

@@ -1,4 +1,4 @@
-import { Sex, SEX } from '../../main'
+import { compareSex, Sex, SEX } from '../../main'
 
 describe('SEX', () => {
   test('should be an array', () => {
@@ -29,3 +29,35 @@ describe('Sex', () => {
     expect(field).toBe('M')
   })
 })
+
+describe('compareSex', () => {
+  test('should return <0 if first argument comes first', () => {
+    expect(compareSex('M', 'F')).toBeLessThan(0)
+  })
+
+  test('should return >0 if second argument comes first', () => {
+    expect(compareSex('F', 'M')).toBeGreaterThan(0)
+  })
+
+  test('should return 0 if arguments match', () => {
+    expect(compareSex('F', 'F')).toBe(0)
+  })
+
+  test('should return 0 if both arguments are undefined', () => {
+    expect(compareSex()).toBe(0)
+  })
+
+  test('should work as a compare function', () => {
+    const unsorted: (Sex | undefined)[] = [undefined, 'M', 'F', 'M', undefined, 'F', 'M']
+    const sorted = unsorted.sort(compareSex)
+
+    expect(sorted).toStrictEqual(['M', 'M', 'M', 'F', 'F', undefined, undefined])
+  })
+
+  test('should sort against undefined', () => {
+    const unsorted: (Sex | undefined)[] = [undefined, 'M']
+    const sorted = unsorted.sort(compareSex)
+
+    expect(sorted).toStrictEqual(['M', undefined])
+  })
+})

package/src/test/api/zone-data.fixture.ts

@@ -4,5 +4,5 @@ import { defineFixture } from 'efate'
 export const zoneDataFixture = defineFixture<ZoneData>((t) => {
   t.key.as(index => `zone-${index}`)
   t.name.as(index => `Zone ${index}`)
-  t.links?.as(() => [{ href: 'https://nouri.org' }])
+  t.links?.as(() => [{ title: 'foo', href: 'https://nouri.org' }])
 })