@nekosuneprojects/honkaistarrail-api 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NekoSuneVR
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @nekosuneprojects/honkaistarrail-api
+
+Node.js 18+ **local-first Honkai: Star Rail** SDK (v1.0.0, not yet published). This standalone branch is independent from the Genshin package.
+
+## Bundled local JSON
+- Game metadata: `data/meta.json`
+- **91** source character JSON records: `data/characters/*.json`
+- Code archive: `data/codes/honkai-star-rail.json` (source labels: **0 verified Active**, **224 Expired**, **12 Unknown/unverified**)
+
+**Important:** These code-status labels come from an older scraped source snapshot, *not* live redemption verification. The 7 November 2026 audit removed 81 incorrectly scraped character names and reward fragments, moved eight historically listed codes to Unknown, and added four newer code reports under Unknown. **No entries are verified currently redeemable**. `codes.active()` is intentionally empty pending actual verification. `codes.verifiedActive()` intentionally returns an empty array until reliable code verification is implemented. Redemption: https://hsr.hoyoverse.com/gift
+
+## Installation after release
+```sh
+npm install @nekosuneprojects/honkaistarrail-api@1.0.0
+```
+
+## Usage
+```js
+const HSR = require('@nekosuneprojects/honkaistarrail-api');
+const hsr = HSR();
+const game = await hsr.About();
+const character = await hsr.character('acheron');
+const allCharacters = await hsr.characters.list();
+const results = await hsr.characters.search('Lightning');
+const historicalCodes = await hsr.codes.snapshot();
+const unverifiedCodeReports = await hsr.codes.unknown();
+const verified = await hsr.codes.verifiedActive(); // [] until verified
+console.log(game.name,character.name,allCharacters.length,results.total);
+```
+
+### Optional live Enka.Network HSR player lookup
+```js
+const uid='601499975'; // Example only; never hardcoded by the SDK
+const profile=await hsr.enka.player(uid); // Alias: hsr.player(uid)
+console.log(profile.detailInfo.nickname,profile.detailInfo.level);
+const displayed=await hsr.enka.avatars(uid);
+console.log(displayed[0]?.relicList,displayed[0]?.equipment,displayed[0]?.skillTreeList);
+const info=await hsr.enka.info(uid); // Returns detailInfo only, from the same cached request
+```
+
+The live endpoint is `https://enka.network/api/hsr/uid/{UID}`; it returns the raw `detailInfo`, optional `avatarDetailList`, `recordInfo`, relics, Light Cone equipment, `ttl`, UID and region. No response properties are renamed. An account's public showcase may be empty or disabled. Enka's policies require a custom User-Agent, avoiding UID enumeration, and observing dynamic rate limits. <https://github.com/EnkaNetwork/API-docs>
+
+## API
+- `About()`, `character(id)`, `characters.get(id)`, `characters.list()`, `characters.search(query)`, `search(query)` — bundled game and character data.
+- `codes.snapshot()`, `codes.active()`, `codes.expired()`, `codes.unknown()`, `codes.all()`, `codes.get(codeOrId)`, `codes.search(query)` — archival JSON status lookups; **not verified live**.
+- `codes.verifiedActive()` — intentionally empty until code verification is implemented.
+- `data.sync()`, `codes.sync()` — optional on-demand sync from the public `JsonData` branch; never automatic on local reads.
+- `enka.player(uid,{refresh,signal})`/`enka.get(uid)` — live Enka response, with in-memory `ttl` caching capped at one hour.
+- `enka.avatars(uid)` — detailed showcased characters or an empty list.
+- `enka.info(uid)` — `detailInfo` from the cached full response (not a separate info-only HTTP endpoint).
+- `enka.clearCache(uid?)` — clear UID cache.
+- Failed requests throw `EnkaError` with `code`, `status` and `retryAfter`; no infinite retries or private-profile bypass.
+
+## Build and publish
+```sh
+npm ci
+npm run check
+npm test
+npm pack --dry-run
+```
+
+Use the shared manual publishing workflow in `main` with `tracker_branch=honkaistarrail-api` after successful tests. Publishing should use npm Trusted Publishing or an appropriately authorised token. No release is triggered by a source push.
+
+## November 7, 2026 data audit
+
+The bundled JSON is synchronized with the corrected `JsonData` source archive:
+
+- **91 character records**: newly added **Pearl**, **Aventurine • Waveflair** and **Robin • Summeretto**. Sources: [HoYoverse Pearl event warp](https://www.hoyolab.com/article/47142215), [released Version 4.6 game data](https://hsr.gachabase.net/characters/release/4.6.0/16707949?lang=en).
+- **81 incorrect code tokens removed** (including character names `Acheron` and `Bronya`, reward text `Credit`, `Fuel` and quantities).
+- **8 older plausible codes** moved to Unknown because August statuses are stale and live redemption was not tested.
+- **4 reported November codes** added under Unknown: `DSLSPNBREASP`, `PEARLAPPRAISE`, `CTK5DRQVT48F`, `SunsweptRobin`. Source claims conflict; do not call them verified.
+- **3 Version 4.7 livestream codes** added as expired: `NEVERGONNAGIVE`, `NEVERGONNAMAKE`, `AHABLESSYOU`; [HoYoLAB source specifies October 31 expiry](https://www.hoyolab.com/article/47252739?reply=1).
+- Two codes, `5S6ZHRWTDNJB` and `4TKSX77Y58QK`, remain in the historic Expired bucket; recent trackers disagree about their current status. Do not promote without reliable verification.
+
+The 7 November playable roster excludes Aeon ★ Aha, whose debut is officially announced for **11 November 2026**. No future character was marked released in this package. Data synchronization is optional and may refresh local content from `JsonData`.

package/data/characters/acheron.json

@@ -0,0 +1,13 @@
+{
+  "name": "Acheron",
+  "rarity": "5-star",
+  "path": "Nihility",
+  "element": "Lightning",
+  "faction": "Independent (claims to be a Galaxy Ranger; is truly an Emanator of Nihility)",
+  "voiceActorEN": "Allegra Clark",
+  "voiceActorJP": "Miyuki Sawashiro",
+  "description": "Real name Raiden Bosenmori Mei, Acheron presents herself as a Galaxy Ranger fighting for justice, but is in truth an Emanator granted power by the Aeon of Nihility. Hailing from the planet Izumo, she ended her homeland's destructive cycle by forging a final blade and experiences time in a non-linear way.",
+  "image": "https://upload.wikimedia.org/wikipedia/en/thumb/e/e6/Acheron_Honkai_Star_Rail.png/250px-Acheron_Honkai_Star_Rail.png",
+  "url": "https://en.wikipedia.org/wiki/Acheron_(Honkai:_Star_Rail)",
+  "slug": "acheron"
+}

package/data/characters/aglaea.json

@@ -0,0 +1,13 @@
+{
+  "name": "Aglaea",
+  "rarity": "5-star",
+  "path": "Remembrance",
+  "element": "Lightning",
+  "faction": "Amphoreus - Okhema",
+  "voiceActorEN": "Morgan Lauré",
+  "voiceActorJP": "Aya Endo",
+  "description": "The Dressmaster of Okhema and one of Amphoreus' Chrysos Heirs, holding the Coreflame of Romance. She maintains the World Wound Web and is renowned as a masterful dressmaker who weaves intricate golden thread. Aglaea was the first Amphoreus character to join the playable roster, debuting in version 3.0.",
+  "image": "https://img.game8.co/4045833/e83dc6b2353dd84813ae7c1d0adb14bc.png/show",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Aglaea",
+  "slug": "aglaea"
+}

package/data/characters/anaxa.json

@@ -0,0 +1,13 @@
+{
+  "name": "Anaxa",
+  "rarity": "5-star",
+  "path": "Erudition",
+  "element": "Wind",
+  "faction": "Amphoreus - Grove of Epiphany",
+  "voiceActorEN": "Stephen Fu",
+  "voiceActorJP": "Yuma Uchida",
+  "description": "Full name Anaxagoras, Anaxa is a Chrysos Heir and one of the Seven Sages of the Grove of Epiphany, credited with introducing the concept of 'Nous.' As an Erudition DPS, his ultimate implants elemental weaknesses onto enemies, making weakness-breaking easier for any team composition.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Anaxa",
+  "slug": "anaxa"
+}

package/data/characters/archer.json

@@ -0,0 +1,29 @@
+{
+  "name": "Archer",
+  "description": "",
+  "image": "https://static.wikia.nocookie.net/houkai-star-rail/images/2/25/Character_Archer_Splash_Art.png/revision/latest?cb=20250620172923",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Archer",
+  "rarity": null,
+  "source": {
+    "provider": "Honkai: Star Rail Wiki",
+    "url": "https://honkai-star-rail.fandom.com/wiki/Archer",
+    "license": "CC BY-SA",
+    "publicDataOnly": true
+  },
+  "details": {},
+  "_sync": {
+    "managed": true,
+    "game": "honkaistarrail",
+    "provider": "fandom-mediawiki",
+    "syncedAt": "2026-08-24T11:04:38.539Z",
+    "officialAnnouncementUrl": null
+  },
+  "path": null,
+  "element": null,
+  "faction": null,
+  "voiceActorEN": null,
+  "voiceActorJP": null,
+  "releaseDate": null,
+  "version": null,
+  "slug": "archer"
+}

package/data/characters/argenti.json

@@ -0,0 +1,13 @@
+{
+  "name": "Argenti",
+  "rarity": "5-star",
+  "path": "Erudition",
+  "element": "Physical",
+  "faction": "Knights of Beauty (independent knight-errant)",
+  "voiceActorEN": "Talon Warburton",
+  "voiceActorJP": "Shinnosuke Tachibana",
+  "description": "A classic knight of the Knights of Beauty, Argenti wanders the cosmos as a knight-errant performing heroic deeds in search of the missing Aeon of Beauty, Idrila. He upholds an old-fashioned code of chivalry and romanticism rare among the game's more cynical spacefarers.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Argenti",
+  "slug": "argenti"
+}

package/data/characters/arlan.json

@@ -0,0 +1,13 @@
+{
+  "name": "Arlan",
+  "rarity": "4-star",
+  "path": "Destruction",
+  "element": "Lightning",
+  "faction": "Herta Space Station",
+  "voiceActorEN": "Dani Chambers",
+  "voiceActorJP": "Ryoko Shiraishi",
+  "description": "Head of the Security Department at Herta Space Station, Arlan is a Destruction-path fighter who channels Lightning damage by sacrificing his own HP instead of consuming Skill Points, growing increasingly dangerous as his health drops.",
+  "image": "",
+  "url": "https://game8.co/games/Honkai-Star-Rail/archives/405754",
+  "slug": "arlan"
+}

package/data/characters/ashveil.json

@@ -0,0 +1,13 @@
+{
+  "name": "Ashveil",
+  "rarity": "5-star",
+  "path": "Hunt",
+  "element": "Lightning",
+  "faction": "Galaxy Rangers (leader)",
+  "voiceActorEN": "Blythe Melin",
+  "voiceActorJP": "Takehito Koyasu",
+  "description": "Introduced as an NPC in Version 4.0 and made playable in Version 4.1, Ashveil poses as a humble private detective on Planarcadia while secretly being La Mancha, the legendary former leader of the Galaxy Rangers. He retired into hiding after leading the Rangers to a great loss.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Ashveil",
+  "slug": "ashveil"
+}

package/data/characters/asta.json

@@ -0,0 +1,13 @@
+{
+  "name": "Asta",
+  "rarity": "4-star",
+  "path": "Harmony",
+  "element": "Fire",
+  "faction": "Herta Space Station",
+  "voiceActorEN": "Felecia Angelle",
+  "voiceActorJP": "Chinatsu Akasaki",
+  "description": "The lead researcher and astronomer of Herta Space Station, Asta is a Fire-aligned Harmony support who boosts her team's Speed and ATK. She is given to players for free early in the game.",
+  "image": "",
+  "url": "https://game8.co/games/Honkai-Star-Rail/archives/405743",
+  "slug": "asta"
+}

package/data/characters/aventurine.json

@@ -0,0 +1,13 @@
+{
+  "name": "Aventurine",
+  "rarity": "5-star",
+  "path": "Preservation",
+  "element": "Imaginary",
+  "faction": "Interastral Peace Corporation (one of the Ten Stonehearts)",
+  "voiceActorEN": "Camden Sutkowski",
+  "voiceActorJP": "Kengo Kawanishi",
+  "description": "Real name Kakavasha, Aventurine is one of the IPC's ten senior executives known as the Ten Stonehearts. The sole survivor of a massacre on his homeworld Sigonia-IV, he endured enslavement before rising through the IPC's ranks, and treats life as a high-risk gamble worth wagering everything on.",
+  "image": "https://upload.wikimedia.org/wikipedia/en/thumb/7/76/Aventurine_in_Honkai_Star_Rail.png/250px-Aventurine_in_Honkai_Star_Rail.png",
+  "url": "https://en.wikipedia.org/wiki/Aventurine_(Honkai:_Star_Rail)",
+  "slug": "aventurine"
+}

package/data/characters/aventurinewaveflair.json

@@ -0,0 +1,14 @@
+{
+  "name": "Aventurine • Waveflair",
+  "rarity": "5-star",
+  "path": "Elation",
+  "element": null,
+  "description": "A distinct playable Aventurine form listed in the Version 4.6 released game-data roster.",
+  "version": "4.5",
+  "slug": "aventurinewaveflair",
+  "source": {
+    "provider": "Gachabase released game data",
+    "url": "https://hsr.gachabase.net/characters/release/4.6.0/16707949?lang=en"
+  },
+  "url": "https://hsr.gachabase.net/characters/release/4.6.0/16707949?lang=en"
+}

package/data/characters/bailu.json

@@ -0,0 +1,13 @@
+{
+  "name": "Bailu",
+  "rarity": "5-star",
+  "path": "Abundance",
+  "element": "Lightning",
+  "faction": "Xianzhou Luofu",
+  "voiceActorEN": "Su Ling Chan",
+  "voiceActorJP": "Emiri Kato",
+  "description": "Bailu is a member of the Vidyadhara, an ancient race gifted with healing powers, and serves as their High Elder. Known affectionately on the Luofu as the 'Healer Lady,' she uses her divine abilities to cure ailments and disasters.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Bailu",
+  "slug": "bailu"
+}

package/data/characters/blackswan.json

@@ -0,0 +1,13 @@
+{
+  "name": "Black Swan",
+  "rarity": "5-star",
+  "path": "Nihility",
+  "element": "Wind",
+  "faction": "Garden of Recollection (Memokeeper)",
+  "voiceActorEN": "Arryn Zech",
+  "voiceActorJP": "Hitomi Nabatame",
+  "description": "Black Swan is a Memokeeper of the Garden of Recollection, a faction that reveres Fuli, the Aeon of Remembrance. She accompanies the Astral Express to Amphoreus and specializes in cursing enemies with damage-over-time Arcana effects drawn from memory and fate.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Black_Swan",
+  "slug": "blackswan"
+}

package/data/characters/blade.json

@@ -0,0 +1,13 @@
+{
+  "name": "Blade",
+  "rarity": "5-star",
+  "path": "Destruction",
+  "element": "Wind",
+  "faction": "Stellaron Hunters",
+  "voiceActorEN": "Daman Mills",
+  "voiceActorJP": "Shin-ichiro Miki",
+  "description": "Real name Yingxing, a member of the criminal Stellaron Hunters and a formerly renowned weaponsmith. He is afflicted with a curse called mara that grants him unwanted immortality and self-healing despite his wish to die.",
+  "image": "https://upload.wikimedia.org/wikipedia/en/b/b0/Blade_HSR_Portrait.png",
+  "url": "https://en.wikipedia.org/wiki/Blade_(Honkai:_Star_Rail)",
+  "slug": "blade"
+}

package/data/characters/boothill.json

@@ -0,0 +1,13 @@
+{
+  "name": "Boothill",
+  "rarity": "5-star",
+  "path": "Hunt",
+  "element": "Physical",
+  "faction": "Galaxy Rangers",
+  "voiceActorEN": "Andrew Russell",
+  "voiceActorJP": "Katsuyuki Konishi",
+  "description": "A cybernetic cowboy and member of the Galaxy Rangers, Boothill seeks revenge on the Interastral Peace Corporation for destroying his home planet, despite the massive bounty they've placed on his own head. A built-in filter called the Synesthesia Beacon involuntarily censors his profanity.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Boothill",
+  "slug": "boothill"
+}

package/data/characters/bronya.json

@@ -0,0 +1,13 @@
+{
+  "name": "Bronya",
+  "rarity": "5-star",
+  "path": "Harmony",
+  "element": "Wind",
+  "faction": "Silvermane Guards",
+  "voiceActorEN": "Madeline Reiter",
+  "voiceActorJP": "Kana Asumi",
+  "description": "Commander of the Silvermane Guards and adoptive daughter of the previous Supreme Guardian Cocolia, Bronya becomes Belobog's Supreme Guardian after resisting her mother's corruption by a Stellaron. Her Harmony-path abilities buff allies' attack and critical damage in battle.",
+  "image": "https://upload.wikimedia.org/wikipedia/en/thumb/e/e5/Bronya_Rand.png/250px-Bronya_Rand.png",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Bronya",
+  "slug": "bronya"
+}

package/data/characters/castorice.json

@@ -0,0 +1,13 @@
+{
+  "name": "Castorice",
+  "rarity": "5-star",
+  "path": "Remembrance",
+  "element": "Quantum",
+  "faction": "Amphoreus - Aidonia",
+  "voiceActorEN": "Melody Muze",
+  "voiceActorJP": "Chiwa Saito",
+  "description": "Castorice is the demigod of Death from the city-state of Aidonia, a Chrysos Heir resurrected through alchemy at great cost and left with a curse that kills any living being she touches. She serves as an executioner and wields a memosprite in the form of a fearsome dragon named Netherwing.",
+  "image": "https://upload.wikimedia.org/wikipedia/en/thumb/e/ec/Castorice_Honkai_Star_Rail.png/250px-Castorice_Honkai_Star_Rail.png",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Castorice",
+  "slug": "castorice"
+}

package/data/characters/cerydra.json

@@ -0,0 +1,13 @@
+{
+  "name": "Cerydra",
+  "rarity": "5-star",
+  "path": "Harmony",
+  "element": "Wind",
+  "faction": "Amphoreus - Okhema",
+  "voiceActorEN": "Rhiannon Moushall",
+  "voiceActorJP": "Kanon Takao",
+  "description": "Cerydra is the demigod of Law and a Chrysos Heir who once ruled as the self-proclaimed sovereign, or Imperator, of the holy city of Okhema. As a niche Harmony support, she buffs allies' Skill usage and Skill DMG through a 'Military Merit' mechanic.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Cerydra",
+  "slug": "cerydra"
+}

package/data/characters/cipher.json

@@ -0,0 +1,13 @@
+{
+  "name": "Cipher",
+  "rarity": "5-star",
+  "path": "Nihility",
+  "element": "Quantum",
+  "faction": "Amphoreus - Dolos",
+  "voiceActorEN": "Shea Fairaday",
+  "voiceActorJP": "Ayasa Ito",
+  "description": "Real name Cifera, Cipher is the demigod of Trickery and a Chrysos Heir hailing from the lost city of Dolos. As a Quantum Nihility character, she applies debuffs to enemies and inflicts True Damage, making her a strong sub-DPS option.",
+  "image": "https://img.game8.co/4168894/e2bf4a196bb04e5d9adfeebe7e11fb50.png/original",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Cipher",
+  "slug": "cipher"
+}

package/data/characters/clara.json

@@ -0,0 +1,13 @@
+{
+  "name": "Clara",
+  "rarity": "5-star",
+  "path": "Destruction",
+  "element": "Physical",
+  "faction": "Belobog Underworld",
+  "voiceActorEN": "Emily Sun",
+  "voiceActorJP": "Rina Hidaka",
+  "description": "A mild-mannered orphan raised in Belobog's Robot Settlement, Clara is the ward of the ancient combat automaton Svarog, whom she treats as family. In battle she draws enemy attacks toward herself so Svarog can shield her and counterattack.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Clara",
+  "slug": "clara"
+}

package/data/characters/constance.json

@@ -0,0 +1,13 @@
+{
+  "name": "Constance",
+  "rarity": "5-star",
+  "path": "Nihility",
+  "element": "Fire",
+  "faction": "The Cremators (posed as a member of the Annihilation Gang's Ever-Flame Mansion)",
+  "voiceActorEN": "Cristina Vee",
+  "voiceActorJP": "Mikoi Sasaki",
+  "description": "Known publicly as 'The Dahlia,' Constance poses as the second daughter of crime lord Duke Inferno within the Annihilation Gang's Ever-Flame Mansion. She is later revealed to actually be a Cremator, a rogue sub-faction of Memokeepers who eliminate memories they deem worthless; she became playable in Version 3.8.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/The_Dahlia",
+  "slug": "constance"
+}

package/data/characters/cyrene.json

@@ -0,0 +1,13 @@
+{
+  "name": "Cyrene",
+  "rarity": "5-star",
+  "path": "Remembrance",
+  "element": "Ice",
+  "faction": "Amphoreus - Aedes Elysiae",
+  "voiceActorEN": "Aiden Dawn",
+  "voiceActorJP": "Marina Inoue",
+  "description": "Cyrene is a Chrysos Heir and Phainon's childhood friend from Aedes Elysiae, initially accompanying the Trailblazer through Amphoreus as a memosprite creature called Mem before transforming into her playable humanoid form. As a Remembrance support, she grants the team True Damage and can fully charge allies' Ultimates.",
+  "image": "https://upload.wikimedia.org/wikipedia/en/1/17/Cyrene_in_Honkai_Star_Rail.png",
+  "url": "https://en.wikipedia.org/wiki/Cyrene_(Honkai:_Star_Rail)",
+  "slug": "cyrene"
+}

package/data/characters/danheng.json

@@ -0,0 +1,13 @@
+{
+  "name": "Dan Heng",
+  "rarity": "4-star",
+  "path": "Hunt",
+  "element": "Wind",
+  "faction": "Astral Express",
+  "voiceActorEN": "Nicholas Leung",
+  "voiceActorJP": "Kent Ito",
+  "description": "A reserved and taciturn member of the Astral Express crew who wields a spear called Cloud-Piercer. He is one of the game's free starting characters and specializes in single-target Wind damage, with a mysterious past tied to the Xianzhou Alliance.",
+  "image": "https://upload.wikimedia.org/wikipedia/en/1/16/Dan_Heng_HSR.png",
+  "url": "https://en.wikipedia.org/wiki/Dan_Heng",
+  "slug": "danheng"
+}

package/data/characters/danhengimbibitorlunae.json

@@ -0,0 +1,29 @@
+{
+  "name": "Dan Heng • Imbibitor Lunae",
+  "description": "",
+  "image": "https://static.wikia.nocookie.net/houkai-star-rail/images/2/2c/Character_Dan_Heng_%E2%80%A2_Imbibitor_Lunae_Splash_Art.png/revision/latest?cb=20230818234313",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Dan_Heng_%E2%80%A2_Imbibitor_Lunae",
+  "rarity": null,
+  "source": {
+    "provider": "Honkai: Star Rail Wiki",
+    "url": "https://honkai-star-rail.fandom.com/wiki/Dan_Heng_%E2%80%A2_Imbibitor_Lunae",
+    "license": "CC BY-SA",
+    "publicDataOnly": true
+  },
+  "details": {},
+  "_sync": {
+    "managed": true,
+    "game": "honkaistarrail",
+    "provider": "fandom-mediawiki",
+    "syncedAt": "2026-08-24T11:04:38.540Z",
+    "officialAnnouncementUrl": null
+  },
+  "path": null,
+  "element": null,
+  "faction": null,
+  "voiceActorEN": null,
+  "voiceActorJP": null,
+  "releaseDate": null,
+  "version": null,
+  "slug": "danhengimbibitorlunae"
+}

package/data/characters/danhengpermansorterrae.json

@@ -0,0 +1,29 @@
+{
+  "name": "Dan Heng • Permansor Terrae",
+  "description": "",
+  "image": "https://static.wikia.nocookie.net/houkai-star-rail/images/1/1f/Character_Dan_Heng_%E2%80%A2_Permansor_Terrae_Splash_Art.png/revision/latest?cb=20250912143415",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Dan_Heng_%E2%80%A2_Permansor_Terrae",
+  "rarity": null,
+  "source": {
+    "provider": "Honkai: Star Rail Wiki",
+    "url": "https://honkai-star-rail.fandom.com/wiki/Dan_Heng_%E2%80%A2_Permansor_Terrae",
+    "license": "CC BY-SA",
+    "publicDataOnly": true
+  },
+  "details": {},
+  "_sync": {
+    "managed": true,
+    "game": "honkaistarrail",
+    "provider": "fandom-mediawiki",
+    "syncedAt": "2026-08-24T11:04:38.541Z",
+    "officialAnnouncementUrl": null
+  },
+  "path": null,
+  "element": null,
+  "faction": null,
+  "voiceActorEN": null,
+  "voiceActorJP": null,
+  "releaseDate": null,
+  "version": null,
+  "slug": "danhengpermansorterrae"
+}

package/data/characters/drratio.json

@@ -0,0 +1,13 @@
+{
+  "name": "Dr. Ratio",
+  "rarity": "5-star",
+  "path": "Hunt",
+  "element": "Imaginary",
+  "faction": "Intelligentsia Guild",
+  "voiceActorEN": "Jordan Haro",
+  "voiceActorJP": "Shunsuke Takeuchi",
+  "description": "Real name Veritas Ratio, Dr. Ratio is a renowned mathematician and scholar of the Intelligentsia Guild who conceals his face behind an alabaster, mask-like head sculpture. He treats ignorance as a disease to be cured, often through blunt, exacting criticism.",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Dr._Ratio",
+  "slug": "drratio"
+}

package/data/characters/evanescia.json

@@ -0,0 +1,29 @@
+{
+  "name": "Evanescia",
+  "description": "",
+  "image": "https://static.wikia.nocookie.net/houkai-star-rail/images/2/2f/Character_Evanescia_Splash_Art.png/revision/latest?cb=20260506070712",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Evanescia",
+  "rarity": null,
+  "source": {
+    "provider": "Honkai: Star Rail Wiki",
+    "url": "https://honkai-star-rail.fandom.com/wiki/Evanescia",
+    "license": "CC BY-SA",
+    "publicDataOnly": true
+  },
+  "details": {},
+  "_sync": {
+    "managed": true,
+    "game": "honkaistarrail",
+    "provider": "fandom-mediawiki",
+    "syncedAt": "2026-08-24T11:04:38.542Z",
+    "officialAnnouncementUrl": null
+  },
+  "path": null,
+  "element": null,
+  "faction": null,
+  "voiceActorEN": null,
+  "voiceActorJP": null,
+  "releaseDate": null,
+  "version": null,
+  "slug": "evanescia"
+}

package/data/characters/evernight.json

@@ -0,0 +1,29 @@
+{
+  "name": "Evernight",
+  "description": "",
+  "image": "https://static.wikia.nocookie.net/houkai-star-rail/images/6/68/Character_Evernight_Splash_Art.png/revision/latest?cb=20250912143541",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Evernight",
+  "rarity": null,
+  "source": {
+    "provider": "Honkai: Star Rail Wiki",
+    "url": "https://honkai-star-rail.fandom.com/wiki/Evernight",
+    "license": "CC BY-SA",
+    "publicDataOnly": true
+  },
+  "details": {},
+  "_sync": {
+    "managed": true,
+    "game": "honkaistarrail",
+    "provider": "fandom-mediawiki",
+    "syncedAt": "2026-08-24T11:04:38.543Z",
+    "officialAnnouncementUrl": null
+  },
+  "path": null,
+  "element": null,
+  "faction": null,
+  "voiceActorEN": null,
+  "voiceActorJP": null,
+  "releaseDate": null,
+  "version": null,
+  "slug": "evernight"
+}

package/data/characters/feixiao.json

@@ -0,0 +1,13 @@
+{
+  "name": "Feixiao",
+  "rarity": "5-star",
+  "path": "Hunt",
+  "element": "Wind",
+  "faction": "Xianzhou Yaoqing",
+  "voiceActorEN": "Anairis Quinones",
+  "voiceActorJP": "Mikako Komatsu",
+  "description": "Feixiao is the current Arbiter-General of the Xianzhou Yaoqing, charged with hunting down calamities that threaten the Xianzhou Alliance. She is renowned for her fierce combat skill and unwavering sense of duty, released as a 5-star character in version 2.5 (September 2024).",
+  "image": "",
+  "url": "https://honkai-star-rail.fandom.com/wiki/Feixiao",
+  "slug": "feixiao"
+}

package/data/characters/firefly.json

@@ -0,0 +1,13 @@
+{
+  "name": "Firefly",
+  "rarity": "5-star",
+  "path": "Destruction",
+  "element": "Fire",
+  "faction": "Stellaron Hunters",
+  "voiceActorEN": "Analesa Fisher",
+  "voiceActorJP": "Tomori Kusunoki",
+  "description": "A genetically engineered soldier from the fallen Republic of Glamoth who pilots the armored SAM combat suit. She suffers from Entropy Loss Syndrome, a fatal degenerative condition, and later joins the Stellaron Hunters.",
+  "image": "https://upload.wikimedia.org/wikipedia/en/thumb/8/86/Firefly_HSR.png/250px-Firefly_HSR.png",
+  "url": "https://en.wikipedia.org/wiki/Firefly_(Honkai:_Star_Rail)",
+  "slug": "firefly"
+}