@nekosuneprojects/gaming-infos 2.2.0 → 3.0.1

package/data/vrchat/players/sodapoppin.json

@@ -1,9 +0,0 @@
-{
-    "name": "Sodapoppin",
-    "species": "Human",
-    "gender": "Male",
-    "aliases": "Soda, Chance",
-    "image": "https://static.wikia.nocookie.net/vrchat-legends/images/6/6c/Rofl_April_24th_2020_60_Sodapoppin.png/revision/latest?cb=20200424234624",
-    "description": "Sodapoppin is a major Twitch personality, historically known for streaming World of Warcraft, who has made recurring guest appearances in VRChat's roleplay scene. His in-VRChat persona is often referred to as Sodapoppin80085 or simply Soda, and he is best known in the community for visiting [Roflgator](https://vrchat-legends.fandom.com/wiki/Roflgator)'s bar communities alongside other prominent streamers such as xQc and Hasanabi.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Sodapoppin"
-}

package/data/vrchat/players/woops.json

@@ -1,9 +0,0 @@
-{
-    "name": "Woops",
-    "title": "The Purple-Haired Fox Girl",
-    "species": "Kitsune (fox girl)",
-    "gender": "Male",
-    "image": "https://static.wikia.nocookie.net/vrchat-legends/images/3/3d/Woops.PNG/revision/latest?cb=20180603105244",
-    "description": "Woops is a VRChat YouTuber and Twitch streamer, one of the five original leaders of [Team Five](https://vrchat-legends.fandom.com/wiki/Team_Five), first known for a custom fox-girl avatar in VRChat's public worlds. Described as happy-go-lucky and mischievous but loyal to friends, he records both roleplay and casual VRChat content for his channel and is affiliated with the [Midnite Central](https://vrchat-legends.fandom.com/wiki/Midnite_Central) community.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Woops"
-}

package/data/vrchat/players/zentreya.json

@@ -1,10 +0,0 @@
-{
-    "name": "Zentreya",
-    "title": "The Red Devil",
-    "species": "Devil/Demon Dragon (formerly Devil/Demon Human)",
-    "gender": "Female",
-    "aliases": "Zen, Fearless Leader",
-    "image": "https://static.wikia.nocookie.net/vrchat-legends/images/0/0e/Zentryey.png/revision/latest?cb=20180529152540",
-    "description": "Zentreya is a roleplayer, streamer, and VTuber who was the leader and founder of the [Anti-Lewd Army](https://vrchat-legends.fandom.com/wiki/Anti-Lewd_Army), a prominent VRChat community faction, earning the nickname 'The Red Devil.' Portrayed as a demon who evolved from a demon-human hybrid into a demon-dragon persona, she is remembered in community lore as a strong-willed, strategic leader with a warmer side beneath a tough exterior. She has since become a well-known independent VTuber on platforms like Twitch and YouTube.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Zentreya"
-}

package/data/vrchat/worlds/ascensionacademy.json

@@ -1,7 +0,0 @@
-{
-    "name": "Ascension Academy",
-    "creator": "Lnik Forstruth",
-    "image": "",
-    "description": "Ascension Academy is a large fantasy-themed roleplay map created by Lnik Forstruth, built as the setting for the Ascension Academy RP series organized by StealthRG (Chipz). Within the fiction of the roleplay, it depicts a military academy that trains cadets in magic, weaponry, and tactics; as a physical VRChat map it provides the classrooms, halls, and grounds used by that community's ongoing storylines. It stands out as one of the more elaborate purpose-built roleplay campuses documented on the wiki.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Ascension_Academy"
-}

package/data/vrchat/worlds/clubvgl.json

@@ -1,8 +0,0 @@
-{
-    "name": "Club VGL",
-    "aliases": "Varneon's Gaming Lounge",
-    "creator": "Varneon",
-    "image": "",
-    "description": "Club VGL is a realistic-looking nightclub world made by Varneon, made public in December 2018. Its name stands for Varneon's Gaming Lounge, and the map includes a dance floor with working lighting, a private catwalk area with a central dance pole, and lockable rooms with jacuzzis. It has been kept updated over the years and remains a recognizable nightclub-style hangout in VRChat.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Club_VGL"
-}

package/data/vrchat/worlds/fightfinder.json

@@ -1,8 +0,0 @@
-{
-    "name": "FIGHT FINDER",
-    "aliases": "Sky Stadium, FIGHT FINDER HUB",
-    "creator": "Gormundr",
-    "image": "",
-    "description": "FIGHT FINDER (originally released as Sky Stadium) is a PC and Quest compatible arena world co-created by Gormundr along with Mortugues, Wobblins, N1no001, and KazeTheAlien. It's built around stadium-style spaces where visitors perform choreographed roleplay fights and showcase avatar animations for recognition within affiliated combat and roleplay sub-groups. After growing quickly in mid-2024, the world and its Discord were rebranded as a permanent public hub supporting many independent fighting-roleplay communities.",
-    "url": "https://vrchat-legends.fandom.com/wiki/FIGHT_FINDER"
-}

package/data/vrchat/worlds/hangouthouse.json

@@ -1,7 +0,0 @@
-{
-    "name": "Hangout House",
-    "creator": "Munificent",
-    "image": "",
-    "description": "Hangout House is an indoor social world created in mid-2018 by the user Munificent. It offers a cozy house-style layout with tabletop-style social games such as chess and four-in-a-row, plus a basement movie theater where visitors can queue up videos to watch together. It has remained a low-key, long-running spot for small-group hangouts rather than a large public party space.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Hangout_House"
-}

package/data/vrchat/worlds/nekostudioshalloween.json

@@ -1,9 +0,0 @@
-{
-    "name": "NekoStudios - Halloween Animations",
-    "title": "Halloween Animations",
-    "creator": "NekoStudios",
-    "aliases": "nekostudios animations",
-    "image": "https://api.vrchat.cloud/api/1/file/file_fae4a508-97c4-4fea-82ff-e16eea083087/1/file",
-    "description": "NekoStudios - Halloween Animations is a festive world featuring holiday-themed animations and decorations. Perfect for celebrating the season with your friends!",
-    "url": "https://vrchat.com/home/world/wrld_bf840eeb-6a85-446b-9734-8f1d63c36ee9"
-}

package/data/vrchat/worlds/nekostudiosnewyear.json

@@ -1,9 +0,0 @@
-{
-    "name": "NekoStudios - New Year Animations",
-    "title": "New Year Animations",
-    "creator": "NekoStudios",
-    "aliases": "nekostudios animations",
-    "image": "https://api.vrchat.cloud/api/1/file/file_ccf6fc05-b0a1-45b4-b4f3-e63460adf69d/1/file",
-    "description": "NekoStudios - New Year Animations is a festive world featuring holiday-themed animations and decorations. Perfect for celebrating the season with your friends!",
-    "url": "https://vrchat.com/home/world/wrld_7d7f9c06-1e16-4eb7-ac9c-cdcdd09e3ed1"
-}

package/data/vrchat/worlds/nekostudiosxmas.json

@@ -1,9 +0,0 @@
-{
-    "name": "NekoStudios - XMAS Animations",
-    "title": "XMAS Animations",
-    "creator": "NekoStudios",
-    "aliases": "nekostudios animations",
-    "image": "https://api.vrchat.cloud/api/1/file/file_6f8aecbb-1e7f-419a-b6fc-eb335866f031/1/file",
-    "description": "NekoStudios - XMAS Animations is a festive world featuring holiday-themed animations and decorations. Perfect for celebrating the season with your friends!",
-    "url": "https://vrchat.com/home/world/wrld_e753bcf7-8c65-4b8f-b5b6-fe0c1ccbd9d9"
-}

package/data/vrchat/worlds/nekosunevranimations2023.json

@@ -1,9 +0,0 @@
-{
-    "name": "NekoSuneVR Animations 2023",
-    "title": "Animations 2023",
-    "creator": "NekoSuneVR",
-    "aliases": "nekostudios animations",
-    "image": "https://api.vrchat.cloud/api/1/file/file_ebcbd7e6-16a5-43a5-bde8-e842ede5f9dc/4/file",
-    "description": "NekoSuneVR Animations World is where NekoSuneVR, formerly part of LatinGang (LTG) back in 2023, left at the end of the year to create their own, NekoStudios. This world features all animations from 2023 to 2024, with an exciting new world coming for 2025 animations—so stay tuned!",
-    "url": "https://vrchat.com/home/world/wrld_f150bf66-e25b-42fb-9cf6-cd87794304c1"
-}

package/data/vrchat/worlds/nekosunevranimations2024.json

@@ -1,9 +0,0 @@
-{
-    "name": "NekoSuneVR Animations 2024",
-    "title": "Animations 2024",
-    "creator": "NekoSuneVR",
-    "aliases": "nekostudios animations",
-    "image": "https://api.vrchat.cloud/api/1/file/file_ff27d04e-2469-4299-86e6-042892c6c2a8/2/file",
-    "description": "NekoSuneVR Animations World is where NekoSuneVR, formerly part of LatinGang (LTG) back in 2023, left at the end of the year to create their own, NekoStudios. This world features all animations from 2023 to 2024, with an exciting new world coming for 2025 animations—so stay tuned!",
-    "url": "https://vrchat.com/home/world/wrld_e5f19a02-2d19-4e37-bef2-e954566ce693"
-}

package/data/vrchat/worlds/nekosunevranimations2025.json

@@ -1,9 +0,0 @@
-{
-    "name": "NekoSuneVR Animations 2025",
-    "title": "Animations 2025",
-    "creator": "NekoSuneVR",
-    "aliases": "nekostudios animations",
-    "image": "https://api.vrchat.cloud/api/1/file/file_35088ee5-4601-40b4-911a-8d7751110aad/2/file",
-    "description": "NekoSuneVR Animations World is where NekoSuneVR, formerly part of LatinGang (LTG) back in 2023, left at the end of the year to create their own, NekoStudios. This world features all animations from 2023 to 2024, with an exciting new world coming for 2025 animations—so stay tuned!",
-    "url": "https://vrchat.com/home/world/wrld_35c3d0ee-72c7-44b7-b518-1ea0ba7cdf66"
-}

package/data/vrchat/worlds/rumhamsavatarworld.json

@@ -1,7 +0,0 @@
-{
-    "name": "Rum Ham's Avatar World",
-    "creator": "Rum Ham",
-    "image": "",
-    "description": "Rum Ham's Avatar World is a meme-focused avatar showcase built by the creator Rum Ham, gathering a large collection of silly and intentionally over-the-top avatars, many accompanied by loud music or sound effects. Numerous avatars use clip-art-style cutouts and figures of internet personalities and celebrities, with Danny DeVito and Nicolas Cage recurring as particular running jokes throughout the world, including a small shrine-style area referencing DeVito. The world has been a favorite drop-in spot for comedic roleplay and random character events within the community.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Rum_Ham's_Avatar_World"
-}

package/data/vrchat/worlds/smewsranch.json

@@ -1,7 +0,0 @@
-{
-    "name": "Smew's Ranch",
-    "creator": "Smew",
-    "image": "",
-    "description": "Smew's Ranch is a follow-up world from creator Smew, built as a lighter, more playful companion to Smew's Room. It has an amusement-park feel, featuring a large Ferris wheel, a roller coaster, and assorted throwable gadgets and toys for visitors to mess around with. Since its release it has steadily grown in popularity as a fun, low-pressure hangout spot.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Smew's_Room"
-}

package/data/vrchat/worlds/smewsroom.json

@@ -1,7 +0,0 @@
-{
-    "name": "Smew's Room",
-    "creator": "Smew",
-    "image": "",
-    "description": "Smew's Room is a Quest-friendly hangout world built by the creator Smew as a comfortable space to relax with friends. Alongside various interactive gadgets, it doubles as a personal museum of sorts, displaying photos from Smew's travels through VRChat. It is also known as the birthplace of Simp Wars, a fan-made Star Wars parody that started here.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Smew's_Room"
-}

package/data/vrchat/worlds/sunsetbar.json

@@ -1,7 +0,0 @@
-{
-    "name": "Sunset Bar",
-    "creator": "Lingie",
-    "image": "",
-    "description": "Sunset Bar is a PCVR and Oculus Quest compatible bar/club world published in August 2023, built to support up to around 60 players per instance. It centers on an elaborate drink-making system with customizable alcohol types, colors, and glassware, alongside a DJ and sound system, private rooms, and a video player. The world grew quickly into one of the more visited bar hangouts in VRChat's social scene.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Sunset_Bar"
-}

package/data/vrchat/worlds/theblackcat.json

@@ -1,9 +0,0 @@
-{
-    "name": "The Black Cat",
-    "title": "Main Hall",
-    "creator": "spookyghostboo",
-    "aliases": "Black Cat",
-    "image": "https://static.wikia.nocookie.net/vrchat-legends/images/2/25/The_Black_Cat_6.png",
-    "description": "The Black Cat is an [Oculus Quest](https://en.wikipedia.org/wiki/Oculus_Quest) enabled world featuring a restaurant, two bars, two stages and many lounging areas. The map is fairly small but roomy enough that its possible to move to a private areas when needed. It has separate bathrooms for male and female visitors. The world has a mirror.",
-    "url": "https://vrchat-legends.fandom.com/wiki/The_Black_Cat"
-}

package/data/vrchat/worlds/thegreatpug.json

@@ -1,8 +0,0 @@
-{
-    "name": "The Great Pug",
-    "title": "Night View Hall",
-    "creator": "owlboy",
-    "image": "",
-    "description": "The Great Pug is a PC-only bar world launched in February 2017 by owlboy, modeled after a real pub called The Great Dane in Madison, Wisconsin. It spans three floors: a ground-floor bar with booths and tables, a second-floor bar and stage area known as Night View Hall with a billiards table, and a top-floor lounge called The Roost with a fireplace and loft seating. It became one of the most iconic early meeting places in VRChat's social and roleplay communities, later spawning a sister world, The Great Pug - West.",
-    "url": "https://vrchat-legends.fandom.com/wiki/The_Great_Pug"
-}

package/data/vrchat/worlds/themidnightbar.json

@@ -1,7 +0,0 @@
-{
-    "name": "The Midnight Bar",
-    "creator": "[Jmelt] Kurisu",
-    "image": "",
-    "description": "The Midnight Bar is an Oculus Quest and PCVR bar world commissioned by the group Midnights In Valhalla and built by [Jmelt] Kurisu. Its design draws inspiration from the visual novel [VA-11 Hall-A](https://en.wikipedia.org/wiki/VA-11_Hall-A), centering on an elaborate drink-mixing system where different concoctions produce different effects on the player. What began as a personal streaming space grew into one of VRChat's most-visited bar worlds, racking up several million visits and spawning a wider community of affiliated bar groups.",
-    "url": "https://vrchat-legends.fandom.com/wiki/The_Midnight_Bar"
-}

package/data/vrchat/worlds/voidclub.json

@@ -1,7 +0,0 @@
-{
-    "name": "Void Club",
-    "creator": "Lycon",
-    "image": "",
-    "description": "Void Club is one of VRChat's earliest well-known dance clubs, created in January 2018 and substantially redesigned in April of that year. It combines a bar, dance floor, and private rooms, and for years ran music around the clock as a public gathering spot. As a long-running, high-traffic public lobby it developed a mixed reputation depending on who visited, but remained an iconic fixture of VRChat's early nightlife scene.",
-    "url": "https://vrchat-legends.fandom.com/wiki/Void_Club"
-}

package/data/vrchat/worlds/voltdanceclub.json

@@ -1,7 +0,0 @@
-{
-    "name": "VOLT Dance Club",
-    "creator": "DigitrevX",
-    "image": "",
-    "description": "VOLT Dance Club is a highly detailed mega-club world created by DigitrevX, featuring custom LED wall visuals, dynamic lighting, multiple bars, private rooms, a dart game, and jacuzzis. It's built to feel like a genuine high-end nightclub experience and even includes an optional RTX ray-tracing graphics mode for compatible Nvidia GPUs. The polish and scale of the build have made it a popular destination among VRChat's club and dance community.",
-    "url": "https://vrchat-legends.fandom.com/wiki/VOLT_Dance_Club"
-}

package/data/vrchat/worlds/vrchathome.json

@@ -1,8 +0,0 @@
-{
-    "name": "VRChat Home",
-    "aliases": "The Hub (former default world)",
-    "creator": "VRChat",
-    "image": "",
-    "description": "VRChat Home is the official default landing world that new players arrive in after finishing the tutorial, replacing the older world known as The Hub and later refreshed by VRChat's own developers. It's set in a calm, space-themed environment with visible stars and galaxies, alien architecture, plants, and decorative motifs like mushrooms, flowers, and rainbows. Signage throughout explains core VRChat features, a mirror area lets new users try on different starter avatars, and portals lead out to a rotating selection of other worlds.",
-    "url": "https://vrchat-legends.fandom.com/wiki/VRChat_Home"
-}

package/data/vrchat/worlds/whatalegend.json

@@ -1,6 +0,0 @@
-{
-    "name": "What a Legend!",
-    "image": "",
-    "description": "What a Legend! is a puzzle-dungeon world originally built as a birthday gift for a VRChat user known as Legend, later released publicly for others to play. Visitors explore a central corridor branching into six themed portal realms, each crafted by a different \"Cheese Guardian\" (including Lakuza, CyanLaser, Mimi, and Phasedragon) with its own puzzles to solve. Collecting all six cheese pieces from these realms unlocks the door to a final room, completing the game-like experience.",
-    "url": "https://vrchat-legends.fandom.com/wiki/What_a_Legend!"
-}

package/data/warframe/meta.json

@@ -1,14 +0,0 @@
-{
-  "name": "Warframe",
-  "title": "Cooperative science-fiction action game by Digital Extremes.",
-  "engine": "Evolution",
-  "Platform": "Windows, PlayStation, Xbox, Nintendo Switch, iOS, Android",
-  "Release date": "March 25, 2013",
-  "Genre": "Action RPG, Third-person shooter, Online co-op",
-  "developers": "Digital Extremes",
-  "publisher": "Digital Extremes",
-  "aliases": "WF, Warframe",
-  "image": "https://www.warframe.com/favicon.ico",
-  "description": "Online action game built around collectible Warframes, weapons, companions and the Origin System.",
-  "url": "https://www.warframe.com/"
-}

package/data/wutheringwaves/meta.json

@@ -1,14 +0,0 @@
-{
-  "name": "Wuthering Waves",
-  "title": "Open-world action RPG by Kuro Games.",
-  "engine": "Unreal Engine 4",
-  "Platform": "Windows, PlayStation 5, iOS, Android, macOS",
-  "Release date": "May 22, 2024",
-  "Genre": "Action RPG, Open World, Gacha",
-  "developers": "Kuro Games",
-  "publisher": "Kuro Games",
-  "aliases": "WuWa, Wuthering Waves",
-  "image": "https://wutheringwaves.kurogames.com/favicon.ico",
-  "description": "Open-world action RPG featuring playable Resonators with distinct attributes and weapons.",
-  "url": "https://wutheringwaves.kurogames.com/"
-}

package/data/zenlesszonezero/meta.json

@@ -1,14 +0,0 @@
-{
-  "name": "Zenless Zone Zero",
-  "title": "Urban fantasy action RPG by HoYoverse.",
-  "engine": "Unity",
-  "Platform": "Windows, PlayStation 5, Xbox Series X/S, iOS, Android",
-  "Release date": "July 4, 2024",
-  "Genre": "Action RPG, Urban Fantasy, Gacha",
-  "developers": "miHoYo",
-  "publisher": "HoYoverse",
-  "aliases": "ZZZ, Zenless Zone Zero",
-  "image": "https://zenless.hoyoverse.com/favicon.ico",
-  "description": "Action RPG featuring playable Agents organized by faction, attribute and specialty.",
-  "url": "https://zenless.hoyoverse.com/"
-}

package/gamecodes.js

@@ -1,178 +0,0 @@
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-const DATA_DIR = path.join(__dirname, 'data', 'game-codes');
-const DEFAULT_API_BASE = 'https://api.nekosunevr.co.uk';
-const DEFAULT_API_PATH = '/v5/games/api/codes';
-const DEFAULT_TIMEOUT_MS = 4000;
-
-function apiBase() {
-  return String(process.env.GAMING_INFOS_API_BASE || DEFAULT_API_BASE).replace(/\/+$/, '');
-}
-
-function apiPath() {
-  const raw = String(process.env.GAME_CODES_API_PATH || DEFAULT_API_PATH).trim();
-  return `/${raw.replace(/^\/+|\/+$/g, '')}`;
-}
-
-function apiDisabled() {
-  const raw = String(process.env.GAMING_INFOS_DISABLE_API || '').toLowerCase();
-  return raw === '1' || raw === 'true';
-}
-
-function timeoutMs() {
-  const raw = Number(process.env.GAMING_INFOS_TIMEOUT_MS);
-  return Number.isFinite(raw) && raw > 0 ? raw : DEFAULT_TIMEOUT_MS;
-}
-
-async function apiGet(suffix = '', query = {}) {
-  if (apiDisabled() || typeof fetch !== 'function') return null;
-
-  const url = new URL(`${apiBase()}${apiPath()}${suffix}`);
-  for (const [key, value] of Object.entries(query)) {
-    if (value !== undefined && value !== null && value !== '') url.searchParams.set(key, String(value));
-  }
-
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), timeoutMs());
-  try {
-    const response = await fetch(url, { signal: controller.signal, headers: { Accept: 'application/json' } });
-    if (!response.ok) return null;
-    const body = await response.json();
-    if (!body || body.success === false) return null;
-    return body;
-  } catch (_) {
-    return null;
-  } finally {
-    clearTimeout(timer);
-  }
-}
-
-async function readJson(filePath) {
-  return JSON.parse(await fs.promises.readFile(filePath, 'utf8'));
-}
-
-function safeFallbackPath(fileName) {
-  const filePath = path.resolve(DATA_DIR, fileName);
-  const root = `${path.resolve(DATA_DIR)}${path.sep}`;
-  return filePath.startsWith(root) ? filePath : null;
-}
-
-async function readFallback(fileName) {
-  const filePath = safeFallbackPath(fileName);
-  if (!filePath || !fs.existsSync(filePath)) return null;
-  try {
-    return await readJson(filePath);
-  } catch (_) {
-    return null;
-  }
-}
-
-function normalizeGame(game) {
-  const slug = String(game || '').trim().toLowerCase();
-  return /^[a-z0-9][a-z0-9-]*$/.test(slug) ? slug : null;
-}
-
-function normalizeCode(code) {
-  return String(code || '').trim().toLowerCase();
-}
-
-async function resolveCachedGame(game) {
-  const slug = normalizeGame(game);
-  if (!slug) return null;
-  if (await readFallback(path.join('games', `${slug}.json`))) return slug;
-
-  const cachedDirectory = await readFallback('directory.json');
-  const aliasTarget = cachedDirectory?.aliases?.[slug];
-  const canonical = normalizeGame(aliasTarget);
-  if (canonical && await readFallback(path.join('games', `${canonical}.json`))) return canonical;
-  return slug;
-}
-
-function filterCachedList(data, options = {}) {
-  if (!data || typeof data !== 'object') return data;
-  const includeUnknown = Boolean(options.includeUnknown);
-  const category = options.category ? String(options.category).toLowerCase() : null;
-  const claimType = options.claimType ? String(options.claimType).toLowerCase() : null;
-
-  const matches = (entry) => {
-    if (!entry || typeof entry !== 'object') return false;
-    if (category && String(entry.category || '').toLowerCase() !== category) return false;
-    if (claimType && String(entry.claimType || '').toLowerCase() !== claimType) return false;
-    return true;
-  };
-
-  const result = {
-    Active: Array.isArray(data.Active) ? data.Active.filter(matches) : [],
-    Expired: Array.isArray(data.Expired) ? data.Expired.filter(matches) : []
-  };
-  if (includeUnknown) result.Unknown = Array.isArray(data.Unknown) ? data.Unknown.filter(matches) : [];
-  return result;
-}
-
-async function directory() {
-  const live = await apiGet('');
-  if (live) return live;
-  const cached = await readFallback('directory.json');
-  return cached || { success: false, error: 'Game code directory is unavailable and no fallback cache exists.' };
-}
-
-async function status() {
-  const live = await apiGet('/status');
-  if (live) return live.data !== undefined ? live.data : live;
-  const cached = await readFallback('status.json');
-  return cached || { error: 'Game code status is unavailable and no fallback cache exists.' };
-}
-
-async function gameCodes(game, options = {}) {
-  if (!game) return { error: 'game is required' };
-  const requested = normalizeGame(game);
-  if (!requested) return { error: 'invalid game slug' };
-  const query = {
-    timezone: options.timezone,
-    category: options.category,
-    claimType: options.claimType,
-    includeUnknown: options.includeUnknown ? 'true' : undefined
-  };
-  const live = await apiGet(`/${encodeURIComponent(requested)}`, query);
-  if (live) return live;
-
-  const cachedGame = await resolveCachedGame(requested);
-  const cached = cachedGame ? await readFallback(path.join('games', `${cachedGame}.json`)) : null;
-  if (!cached) return { error: `No cached game codes found for "${game}".` };
-  return filterCachedList(cached, options);
-}
-
-async function gameCode(game, code, options = {}) {
-  if (!game || !code) return { error: 'game and code are both required' };
-  const requested = normalizeGame(game);
-  if (!requested) return { error: 'invalid game slug' };
-  const codeValue = String(code).trim();
-  const live = await apiGet(`/${encodeURIComponent(requested)}/${encodeURIComponent(codeValue)}`, { timezone: options.timezone });
-  if (live) return live.data !== undefined ? live.data : live;
-
-  const cachedGame = await resolveCachedGame(requested);
-  const cached = cachedGame ? await readFallback(path.join('games', `${cachedGame}.json`)) : null;
-  if (!cached) return { error: `No cached game codes found for "${game}".` };
-  const wanted = normalizeCode(codeValue);
-  for (const bucket of ['Active', 'Expired', 'Unknown']) {
-    for (const entry of Array.isArray(cached[bucket]) ? cached[bucket] : []) {
-      if (normalizeCode(entry?.code) === wanted) return entry;
-    }
-  }
-  return { error: `Code "${code}" not found for game "${game}".` };
-}
-
-async function cacheInfo() {
-  return readFallback('.cache-manifest.json');
-}
-
-module.exports = {
-  Codes: () => directory(),
-  CodesStatus: () => status(),
-  GameCodes: (game, options) => gameCodes(game, options),
-  GameCode: (game, code, options) => gameCode(game, code, options),
-  CodeCacheInfo: () => cacheInfo()
-};

package/scripts/cache-sync-smoke.js

@@ -1,92 +0,0 @@
-'use strict';
-
-const assert = require('assert');
-const fs = require('fs');
-const http = require('http');
-const os = require('os');
-const path = require('path');
-const { syncApiCache } = require('./sync-api-cache');
-
-function json(res, status, body) {
-  const payload = JSON.stringify(body);
-  res.writeHead(status, { 'content-type': 'application/json', 'content-length': Buffer.byteLength(payload) });
-  res.end(payload);
-}
-
-async function main() {
-  const root = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'gaming-infos-cache-test-'));
-  const dataDir = path.join(root, 'data');
-  let failCharacters = false;
-  let characters = [
-    { slug: 'alpha', name: 'Alpha', value: 1 },
-    { slug: 'beta', name: 'Beta', value: 2 }
-  ];
-
-  const server = http.createServer((req, res) => {
-    if (req.url === '/v5/games/api/gaming-infos') {
-      return json(res, 200, { success: true, data: [{ name: 'Test Game' }] });
-    }
-    if (req.url === '/v5/games/api/gaming-infos/testgame/meta/testgame') {
-      return json(res, 200, { success: true, data: { name: 'Test Game', description: 'fixture' } });
-    }
-    if (req.url === '/v5/games/api/gaming-infos/testgame/characters') {
-      if (failCharacters) return json(res, 503, { success: false, error: 'fixture outage' });
-      return json(res, 200, { success: true, data: characters });
-    }
-    return json(res, 404, { success: false, error: 'not found' });
-  });
-
-  await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
-  const address = server.address();
-  const apiBase = `http://127.0.0.1:${address.port}`;
-  const options = {
-    apiBase,
-    apiPath: '/v5/games/api/gaming-infos',
-    dataDir,
-    manifest: { testgame: ['characters'] },
-    retries: 0,
-    timeoutMs: 3000
-  };
-
-  try {
-    const first = await syncApiCache(options);
-    assert.strictEqual(first.changed, true);
-    assert.ok(fs.existsSync(path.join(dataDir, 'testgame', 'characters', 'alpha.json')));
-    assert.ok(fs.existsSync(path.join(dataDir, 'testgame', 'characters', 'beta.json')));
-
-    characters = [
-      { slug: 'alpha', name: 'Alpha', value: 99 },
-      { slug: 'gamma', name: 'Gamma', value: 3 }
-    ];
-    const second = await syncApiCache(options);
-    assert.strictEqual(second.changed, true);
-    assert.strictEqual(second.stats.added, 1);
-    assert.strictEqual(second.stats.removed, 1);
-    assert.ok(second.stats.changed >= 1);
-    assert.strictEqual(JSON.parse(await fs.promises.readFile(path.join(dataDir, 'testgame', 'characters', 'alpha.json'), 'utf8')).value, 99);
-    assert.ok(fs.existsSync(path.join(dataDir, 'testgame', 'characters', 'gamma.json')));
-    assert.ok(!fs.existsSync(path.join(dataDir, 'testgame', 'characters', 'beta.json')));
-
-    const beforeOutage = await fs.promises.readFile(path.join(dataDir, 'testgame', 'characters', 'alpha.json'), 'utf8');
-    failCharacters = true;
-    let failed = false;
-    try {
-      await syncApiCache(options);
-    } catch (_) {
-      failed = true;
-    }
-    assert.strictEqual(failed, true, 'partial API outage must fail the sync');
-    assert.strictEqual(await fs.promises.readFile(path.join(dataDir, 'testgame', 'characters', 'alpha.json'), 'utf8'), beforeOutage);
-    assert.ok(fs.existsSync(path.join(dataDir, 'testgame', 'characters', 'gamma.json')), 'last good snapshot must survive an outage');
-
-    console.log('gaming-infos cache sync smoke test passed');
-  } finally {
-    await new Promise((resolve) => server.close(resolve));
-    await fs.promises.rm(root, { recursive: true, force: true });
-  }
-}
-
-main().catch((error) => {
-  console.error(error);
-  process.exitCode = 1;
-});