@nekosuneprojects/warframe-api 1.0.0 → 1.0.1

package/src/data-store.js

@@ -1,138 +1,138 @@
-'use strict';
-const fs = require('node:fs/promises');
-const path = require('node:path');
-const os = require('node:os');
-
-function safePath(value) {
-  if (typeof value !== 'string' || !value || value.includes('\\') || value.includes('\0') ||
-      value.startsWith('/') || value.split('/').some(v => !v || v === '.' || v === '..') ||
-      !/^[a-zA-Z0-9_./-]+$/.test(value)) throw new TypeError('Unsafe JSON data path');
-  if (!value.endsWith('.json')) throw new TypeError('Only .json files are supported');
-  return value;
-}
-function sourceConfig(source) {
-  if (!source) return null;
-  const { owner, repo, branch = 'main', directory } = source;
-  for (const part of [owner, repo, branch]) {
-    if (typeof part !== 'string' || !/^[a-zA-Z0-9._-]+$/.test(part)) throw new TypeError('Invalid GitHub repository source');
-  }
-  if (typeof directory !== 'string' || !directory || directory.split('/').some(x => !x || x === '.' || x === '..') ||
-      !/^[a-zA-Z0-9_/-]+$/.test(directory)) throw new TypeError('Invalid GitHub source directory');
-  return { owner, repo, branch, directory };
-}
-function createDataStore({ gameId, cacheDir, bundledDir, github, githubToken, syncFiles, fetchImpl = globalThis.fetch } = {}) {
-  if (typeof gameId !== 'string' || !/^[a-z0-9][a-z0-9_-]*$/.test(gameId)) throw new TypeError('Valid gameId required');
-  if (typeof fetchImpl !== 'function') throw new TypeError('fetch is required');
-  const source = sourceConfig(github);
-  if (syncFiles !== undefined && (!Array.isArray(syncFiles) || syncFiles.length === 0)) throw new TypeError('syncFiles must be a nonempty array of JSON paths');
-  const whitelist = syncFiles === undefined ? null : new Set(syncFiles.map(safePath));
-  if (githubToken !== undefined && (typeof githubToken !== 'string' || !githubToken.trim())) throw new TypeError('githubToken must be a nonempty string');
-  const githubHeaders = { Accept: 'application/vnd.github+json', 'User-Agent': 'NekoSune-Game-Tracker', ...(githubToken ? { Authorization: 'Bearer ' + githubToken } : {}) };
-  const cache = path.resolve(cacheDir || path.join(os.homedir(), '.cache', 'nekosune-game-tracker', gameId));
-  const bundled = bundledDir ? path.resolve(bundledDir) : null;
-  const manifestFile = path.join(cache, '.manifest.json');
-  async function loadManifest() {
-    try {
-      const current = JSON.parse(await fs.readFile(manifestFile, 'utf8'));
-      if (current.source !== JSON.stringify({source, files: syncFiles || null}) || !current.files || typeof current.files !== 'object') return {};
-      return current.files;
-    } catch (err) { if (err.code === 'ENOENT' || err instanceof SyntaxError) return {}; throw err; }
-  }
-  async function atomicWrite(file, content) {
-    await fs.mkdir(path.dirname(file), { recursive: true });
-    const tmp = file + '.' + process.pid + '.' + require('node:crypto').randomBytes(6).toString('hex') + '.tmp';
-    try { await fs.writeFile(tmp, content); await fs.rename(tmp, file); }
-    catch (err) { await fs.rm(tmp, { force: true }); throw err; }
-  }
-  async function get(file) {
-    const relative = safePath(file);
-    for (const base of [cache, bundled].filter(Boolean)) {
-      try { return JSON.parse(await fs.readFile(path.join(base, relative), 'utf8')); }
-      catch (err) { if (err.code !== 'ENOENT') throw err; }
-    }
-    throw Object.assign(new Error('Local JSON not found: ' + relative), { code: 'ENOENT' });
-  }
-  async function list() {
-    const results = new Set();
-    async function walk(dir, relative = '') {
-      let entries;
-      try { entries = await fs.readdir(dir, { withFileTypes: true }); }
-      catch (err) { if (err.code === 'ENOENT') return; throw err; }
-      for (const entry of entries) {
-        if (entry.isSymbolicLink()) continue;
-        const rel = relative ? relative + '/' + entry.name : entry.name;
-        if (entry.isDirectory()) await walk(path.join(dir, entry.name), rel);
-        else if (entry.isFile() && rel.endsWith('.json') && rel !== '.manifest.json') {
-          try { safePath(rel); results.add(rel); } catch {}
-        }
-      }
-    }
-    if (bundled) await walk(bundled);
-    await walk(cache);
-    return [...results].sort();
-  }
-  async function sync({ signal } = {}) {
-    if (!source) throw new Error('No GitHub JSON source configured in this tracker branch');
-    const { owner, repo, branch, directory } = source;
-    const api = 'https://api.github.com/repos/' + owner + '/' + repo + '/git/trees/' + encodeURIComponent(branch) + '?recursive=1';
-    const request = await fetchImpl(api, { headers: githubHeaders, signal });
-    if (!request.ok) throw new Error('GitHub tree request failed: HTTP ' + request.status);
-    const tree = await request.json();
-    if (tree.truncated || !Array.isArray(tree.tree)) throw new Error('GitHub directory listing incomplete; refusing partial sync');
-    const prefix = directory + '/';
-    const files = tree.tree.filter(item => item.type === 'blob' && item.path.startsWith(prefix) && item.path.endsWith('.json') && (!whitelist || whitelist.has(item.path.slice(prefix.length))))
-      .map(item => ({ name: safePath(item.path.slice(prefix.length)), sha: item.sha, size: item.size }));
-    if (files.length > 5000) throw new Error('Too many JSON files');
-    const old = await loadManifest();
-    const next = { ...old };
-    let updated = 0, unchanged = 0;
-    for (const item of files) {
-      if (!/^[0-9a-f]{40}$/.test(item.sha) || item.size > 5 * 1024 * 1024) throw new Error('Invalid or oversized GitHub JSON blob');
-      const target = path.join(cache, item.name);
-      if (old[item.name] === item.sha) {
-        try {
-          const existing = await fs.readFile(target);
-          const existingHash = require('node:crypto').createHash('sha1')
-            .update('blob ' + existing.length + '\0').update(existing).digest('hex');
-          JSON.parse(existing.toString('utf8'));
-          if (existingHash === item.sha) { unchanged++; continue; }
-        } catch (err) {
-          if (err.code !== 'ENOENT' && !(err instanceof SyntaxError)) throw err;
-        }
-      }
-      // GitHub Git Blob API supports private repositories with a fine-grained read token.
-      // Fetch by content SHA so the downloaded file matches the exact tree snapshot.
-      const blobUrl = 'https://api.github.com/repos/' + owner + '/' + repo + '/git/blobs/' + item.sha;
-      const response = await fetchImpl(blobUrl, { headers: githubHeaders, signal });
-      if (!response.ok) throw new Error('GitHub JSON download failed (' + item.name + '): HTTP ' + response.status);
-      const blob = await response.json();
-      if (blob.encoding !== 'base64' || typeof blob.content !== 'string')
-        throw new Error('Unexpected GitHub blob encoding for ' + item.name);
-      const buffer = Buffer.from(blob.content.replace(/\s/g, ''), 'base64');
-      if (buffer.length > 5 * 1024 * 1024) throw new Error('JSON file too large');
-      const gitHash = require('node:crypto').createHash('sha1').update('blob ' + buffer.length + '\0').update(buffer).digest('hex');
-      if (gitHash !== item.sha) throw new Error('GitHub JSON checksum mismatch: ' + item.name);
-      JSON.parse(buffer.toString('utf8'));
-      await atomicWrite(target, buffer);
-      next[item.name] = item.sha;
-      updated++;
-    }
-    // Cache is additive: do not automatically delete removed upstream files or user files.
-    await atomicWrite(manifestFile, JSON.stringify({ source: JSON.stringify({source, files: syncFiles || null}), files: next }, null, 2) + '\n');
-    return { updated, unchanged, checked: files.length, cacheDir: cache };
-  }
-  // Ensures a newly published remote JSON record is available even when it
-  // was absent from the npm package and from this machine's cache.
-  async function ensure(file, { signal, refresh = false } = {}) {
-    const relative = safePath(file);
-    if (!refresh) {
-      try { return await get(relative); }
-      catch (err) { if (err.code !== 'ENOENT') throw err; }
-    }
-    if (!source) return get(relative);
-    await sync({ signal });
-    return get(relative);
-  }
-  return Object.freeze({ get, list, sync, ensure, cacheDir: cache });
-}
-module.exports = { createDataStore };
+'use strict';
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const os = require('node:os');
+
+function safePath(value) {
+  if (typeof value !== 'string' || !value || value.includes('\\') || value.includes('\0') ||
+      value.startsWith('/') || value.split('/').some(v => !v || v === '.' || v === '..') ||
+      !/^[a-zA-Z0-9_./-]+$/.test(value)) throw new TypeError('Unsafe JSON data path');
+  if (!value.endsWith('.json')) throw new TypeError('Only .json files are supported');
+  return value;
+}
+function sourceConfig(source) {
+  if (!source) return null;
+  const { owner, repo, branch = 'main', directory } = source;
+  for (const part of [owner, repo, branch]) {
+    if (typeof part !== 'string' || !/^[a-zA-Z0-9._-]+$/.test(part)) throw new TypeError('Invalid GitHub repository source');
+  }
+  if (typeof directory !== 'string' || !directory || directory.split('/').some(x => !x || x === '.' || x === '..') ||
+      !/^[a-zA-Z0-9_/-]+$/.test(directory)) throw new TypeError('Invalid GitHub source directory');
+  return { owner, repo, branch, directory };
+}
+function createDataStore({ gameId, cacheDir, bundledDir, github, githubToken, syncFiles, fetchImpl = globalThis.fetch } = {}) {
+  if (typeof gameId !== 'string' || !/^[a-z0-9][a-z0-9_-]*$/.test(gameId)) throw new TypeError('Valid gameId required');
+  if (typeof fetchImpl !== 'function') throw new TypeError('fetch is required');
+  const source = sourceConfig(github);
+  if (syncFiles !== undefined && (!Array.isArray(syncFiles) || syncFiles.length === 0)) throw new TypeError('syncFiles must be a nonempty array of JSON paths');
+  const whitelist = syncFiles === undefined ? null : new Set(syncFiles.map(safePath));
+  if (githubToken !== undefined && (typeof githubToken !== 'string' || !githubToken.trim())) throw new TypeError('githubToken must be a nonempty string');
+  const githubHeaders = { Accept: 'application/vnd.github+json', 'User-Agent': 'NekoSune-Game-Tracker', ...(githubToken ? { Authorization: 'Bearer ' + githubToken } : {}) };
+  const cache = path.resolve(cacheDir || path.join(os.homedir(), '.cache', 'nekosune-game-tracker', gameId));
+  const bundled = bundledDir ? path.resolve(bundledDir) : null;
+  const manifestFile = path.join(cache, '.manifest.json');
+  async function loadManifest() {
+    try {
+      const current = JSON.parse(await fs.readFile(manifestFile, 'utf8'));
+      if (current.source !== JSON.stringify({source, files: syncFiles || null}) || !current.files || typeof current.files !== 'object') return {};
+      return current.files;
+    } catch (err) { if (err.code === 'ENOENT' || err instanceof SyntaxError) return {}; throw err; }
+  }
+  async function atomicWrite(file, content) {
+    await fs.mkdir(path.dirname(file), { recursive: true });
+    const tmp = file + '.' + process.pid + '.' + require('node:crypto').randomBytes(6).toString('hex') + '.tmp';
+    try { await fs.writeFile(tmp, content); await fs.rename(tmp, file); }
+    catch (err) { await fs.rm(tmp, { force: true }); throw err; }
+  }
+  async function get(file) {
+    const relative = safePath(file);
+    for (const base of [cache, bundled].filter(Boolean)) {
+      try { return JSON.parse(await fs.readFile(path.join(base, relative), 'utf8')); }
+      catch (err) { if (err.code !== 'ENOENT') throw err; }
+    }
+    throw Object.assign(new Error('Local JSON not found: ' + relative), { code: 'ENOENT' });
+  }
+  async function list() {
+    const results = new Set();
+    async function walk(dir, relative = '') {
+      let entries;
+      try { entries = await fs.readdir(dir, { withFileTypes: true }); }
+      catch (err) { if (err.code === 'ENOENT') return; throw err; }
+      for (const entry of entries) {
+        if (entry.isSymbolicLink()) continue;
+        const rel = relative ? relative + '/' + entry.name : entry.name;
+        if (entry.isDirectory()) await walk(path.join(dir, entry.name), rel);
+        else if (entry.isFile() && rel.endsWith('.json') && rel !== '.manifest.json') {
+          try { safePath(rel); results.add(rel); } catch {}
+        }
+      }
+    }
+    if (bundled) await walk(bundled);
+    await walk(cache);
+    return [...results].sort();
+  }
+  async function sync({ signal } = {}) {
+    if (!source) throw new Error('No GitHub JSON source configured in this tracker branch');
+    const { owner, repo, branch, directory } = source;
+    const api = 'https://api.github.com/repos/' + owner + '/' + repo + '/git/trees/' + encodeURIComponent(branch) + '?recursive=1';
+    const request = await fetchImpl(api, { headers: githubHeaders, signal });
+    if (!request.ok) throw new Error('GitHub tree request failed: HTTP ' + request.status);
+    const tree = await request.json();
+    if (tree.truncated || !Array.isArray(tree.tree)) throw new Error('GitHub directory listing incomplete; refusing partial sync');
+    const prefix = directory + '/';
+    const files = tree.tree.filter(item => item.type === 'blob' && item.path.startsWith(prefix) && item.path.endsWith('.json') && (!whitelist || whitelist.has(item.path.slice(prefix.length))))
+      .map(item => ({ name: safePath(item.path.slice(prefix.length)), sha: item.sha, size: item.size }));
+    if (files.length > 5000) throw new Error('Too many JSON files');
+    const old = await loadManifest();
+    const next = { ...old };
+    let updated = 0, unchanged = 0;
+    for (const item of files) {
+      if (!/^[0-9a-f]{40}$/.test(item.sha) || item.size > 5 * 1024 * 1024) throw new Error('Invalid or oversized GitHub JSON blob');
+      const target = path.join(cache, item.name);
+      if (old[item.name] === item.sha) {
+        try {
+          const existing = await fs.readFile(target);
+          const existingHash = require('node:crypto').createHash('sha1')
+            .update('blob ' + existing.length + '\0').update(existing).digest('hex');
+          JSON.parse(existing.toString('utf8'));
+          if (existingHash === item.sha) { unchanged++; continue; }
+        } catch (err) {
+          if (err.code !== 'ENOENT' && !(err instanceof SyntaxError)) throw err;
+        }
+      }
+      // GitHub Git Blob API supports private repositories with a fine-grained read token.
+      // Fetch by content SHA so the downloaded file matches the exact tree snapshot.
+      const blobUrl = 'https://api.github.com/repos/' + owner + '/' + repo + '/git/blobs/' + item.sha;
+      const response = await fetchImpl(blobUrl, { headers: githubHeaders, signal });
+      if (!response.ok) throw new Error('GitHub JSON download failed (' + item.name + '): HTTP ' + response.status);
+      const blob = await response.json();
+      if (blob.encoding !== 'base64' || typeof blob.content !== 'string')
+        throw new Error('Unexpected GitHub blob encoding for ' + item.name);
+      const buffer = Buffer.from(blob.content.replace(/\s/g, ''), 'base64');
+      if (buffer.length > 5 * 1024 * 1024) throw new Error('JSON file too large');
+      const gitHash = require('node:crypto').createHash('sha1').update('blob ' + buffer.length + '\0').update(buffer).digest('hex');
+      if (gitHash !== item.sha) throw new Error('GitHub JSON checksum mismatch: ' + item.name);
+      JSON.parse(buffer.toString('utf8'));
+      await atomicWrite(target, buffer);
+      next[item.name] = item.sha;
+      updated++;
+    }
+    // Cache is additive: do not automatically delete removed upstream files or user files.
+    await atomicWrite(manifestFile, JSON.stringify({ source: JSON.stringify({source, files: syncFiles || null}), files: next }, null, 2) + '\n');
+    return { updated, unchanged, checked: files.length, cacheDir: cache };
+  }
+  // Ensures a newly published remote JSON record is available even when it
+  // was absent from the npm package and from this machine's cache.
+  async function ensure(file, { signal, refresh = false } = {}) {
+    const relative = safePath(file);
+    if (!refresh) {
+      try { return await get(relative); }
+      catch (err) { if (err.code !== 'ENOENT') throw err; }
+    }
+    if (!source) return get(relative);
+    await sync({ signal });
+    return get(relative);
+  }
+  return Object.freeze({ get, list, sync, ensure, cacheDir: cache });
+}
+module.exports = { createDataStore };

package/src/provider.js

@@ -1,22 +1,22 @@
-'use strict';
-const BASE = 'https://api.warframestat.us/';
-const PLATFORMS = Object.freeze(['pc','ps4','psn','xb1','swi','ns']);
-const WORLDSTATE_FIELDS = Object.freeze([
-  'alerts','arbitration','archonHunt','cambionCycle','cetusCycle','conclaveChallenges',
-  'constructionProgress','dailyDeals','darvo','earthCycle','events','fissures',
-  'flashSales','globalUpgrades','invasions','kuva','news','nightwave','persistentEnemies',
-  'sentientOutposts','simaris','sortie','steelPath','syndicateMissions','thermia',
-  'vallisCycle','voidTrader','weeklyChallenges'
-]);
-const STATIC_KEYS = Object.freeze([
-  'arcanes','synthTargets','solNodes','conclave','events','operationTypes',
-  'persistentEnemy','sortie','upgradeTypes','fissureModifiers','archonShards',
-  'factions','missionTypes','languages','locales','mods','weapons','warframes','items'
-]);
-module.exports = Object.freeze({
-  baseUrl: BASE,
-  auth: Object.freeze({type:'none'}),
-  platforms: PLATFORMS,
-  worldstateFields: WORLDSTATE_FIELDS,
-  staticKeys: STATIC_KEYS
-});
+'use strict';
+const BASE = 'https://api.warframestat.us/';
+const PLATFORMS = Object.freeze(['pc','ps4','psn','xb1','swi','ns']);
+const WORLDSTATE_FIELDS = Object.freeze([
+  'alerts','arbitration','archonHunt','cambionCycle','cetusCycle','conclaveChallenges',
+  'constructionProgress','dailyDeals','darvo','earthCycle','events','fissures',
+  'flashSales','globalUpgrades','invasions','kuva','news','nightwave','persistentEnemies',
+  'sentientOutposts','simaris','sortie','steelPath','syndicateMissions','thermia',
+  'vallisCycle','voidTrader','weeklyChallenges'
+]);
+const STATIC_KEYS = Object.freeze([
+  'arcanes','synthTargets','solNodes','conclave','events','operationTypes',
+  'persistentEnemy','sortie','upgradeTypes','fissureModifiers','archonShards',
+  'factions','missionTypes','languages','locales','mods','weapons','warframes','items'
+]);
+module.exports = Object.freeze({
+  baseUrl: BASE,
+  auth: Object.freeze({type:'none'}),
+  platforms: PLATFORMS,
+  worldstateFields: WORLDSTATE_FIELDS,
+  staticKeys: STATIC_KEYS
+});

package/src/tracker.js

@@ -1,115 +1,115 @@
-'use strict';
-const provider=require('./provider');
-const {createWarframeClient,parameter,optionsQuery}=require('./warframe-client');
-const {createDataStore}=require('./data-store');
-const {createCatalog}=require('./catalog');
-const {createWarframeCodes}=require('./warframe-codes');
-const {createWFCD,createMarketQuery,createUpdateMonitor}=require('./wfcd');
-const {TrackerError}=require('./client-error');
-
-const itemTypes=new Set(['warframes','weapons','items','mods']);
-const id=v=>parameter(v,'identifier');
-function platformOf(value) {
-  const p=value||'pc';
-  if(!provider.platforms.includes(p))throw new RangeError('Unsupported platform '+p);
-  return p;
-}
-function createWarframeTracker({platform='pc',language='en',timeoutMs=15000,cacheDir,githubToken,fetchImpl}={}) {
-  const selected=platformOf(platform);
-  const {request}=createWarframeClient({language,timeoutMs,fetchImpl});
-  const data=createDataStore({
-    gameId:'warframe', github:{owner:'NekoSuneProjectsNPM',repo:'game-tracker',branch:'JsonData',directory:'games/warframe'},
-    bundledDir:require('node:path').join(__dirname,'..','data'),
-    cacheDir, githubToken, fetchImpl
-  });
-  const catalog=createCatalog(data);
-  // Local-first: only query GitHub if a requested character is absent.
-  // Existing bundled and cached characters work without any network call.
-  async function character(name, options = {}) {
-    try { return await catalog.character(name); }
-    catch (err) {
-      if (err.code !== 'NOT_FOUND') throw err;
-      if (options.refresh === false) throw err;
-      await data.sync({ signal: options.signal });
-      return catalog.character(name);
-    }
-  }
-  // Set refresh:true to discover new records that didn't exist in local JSON.
-  async function search(query, options = {}) {
-    if (options.refresh === true) await data.sync({ signal: options.signal });
-    return catalog.search(query, options);
-  }
-  const codes=createWarframeCodes({cacheDir,githubToken,fetchImpl});
-  const wfcd=createWFCD({cacheDir,githubToken,fetchImpl});
-  const worldstate=(field,options={})=>{
-    if(typeof field!=='string' || !/^[a-zA-Z][a-zA-Z0-9]*$/.test(field)) throw new TypeError('Invalid worldstate field');
-    return request(selected+'/'+field,optionsQuery(options,['filter']));
-  };
-  const listing=(kind,options={})=>{
-    if(!itemTypes.has(kind))throw new RangeError('Unknown item type');
-    return request(kind,optionsQuery(options,['language','filter','only','remove']));
-  };
-  const single=(kind,name,options={})=>{
-    if(!itemTypes.has(kind))throw new RangeError('Unknown item type');
-    return request(kind+'/'+id(name),optionsQuery(options,['language','filter','only','remove','by']));
-  };
-  const find=(kind,query,options={})=>{
-    if(!itemTypes.has(kind))throw new RangeError('Unknown item type');
-    return request(kind+'/search/'+id(query),optionsQuery(options,['language','filter','only','remove','by']));
-  };
-  const api=Object.freeze({
-    health:()=>request('health'),
-    worldstate:()=>request(selected),
-    worldstateField:(field,options)=>worldstate(field,options),
-    profile:(playerId,options)=>request('profile/'+id(playerId),optionsQuery(options,['language','withItem'])),
-    profileStats:playerId=>request('profile/'+id(playerId)+'/stats'),
-    profileXP:(playerId,options)=>request('profile/'+id(playerId)+'/xpInfo',optionsQuery(options,['withItem'])),
-    list:listing,
-    get:single,
-    search:find,
-    warframes:options=>listing('warframes',options),
-    weapons:options=>listing('weapons',options),
-    items:options=>listing('items',options),
-    mods:options=>listing('mods',options),
-    warframe:(name,options)=>single('warframes',name,options),
-    weapon:(name,options)=>single('weapons',name,options),
-    item:(name,options)=>single('items',name,options),
-    mod:(name,options)=>single('mods',name,options),
-    searchWarframes:(q,options)=>find('warframes',q,options),
-    searchWeapons:(q,options)=>find('weapons',q,options),
-    searchItems:(q,options)=>find('items',q,options),
-    searchMods:(q,options)=>find('mods',q,options),
-    drops:()=>request('drops'),
-    searchDrops:(query,options)=>request('drops/search/'+id(query),optionsQuery(options,['grouped_by'])),
-    rivens:()=>request(selected+'/rivens'),
-    searchRivens:query=>request(selected+'/rivens/search/'+id(query)),
-    staticData:(key,options)=>request(id(key),optionsQuery(options,['language'])),
-    searchStatic:(key,query,options)=>request(id(key)+'/search/'+id(query),optionsQuery(options,['language'])),
-    synthTargets:options=>request('synthTargets',optionsQuery(options,['language'])),
-    arcanes:options=>request('arcanes',optionsQuery(options,['language'])),
-    rss:()=>request('rss'),
-    twitter:()=>request('twitter'),
-    wfinfoFilteredItems:()=>request('wfinfo/filtered_items'),
-    wfinfoPrices:()=>request('wfinfo/prices')
-  });
-  const fields=Object.fromEntries(provider.worldstateFields.filter(k=>!Object.hasOwn(api,k)).map(k=>[k,options=>worldstate(k,options)]));
-  const fullApi=Object.freeze({...api,...fields});
-  return Object.freeze({
-    api:fullApi,
-    data,
-    codes,
-    wfcd,
-    market:createMarketQuery,
-    createUpdateMonitor,
-    code:codes.get,
-    About:()=>data.get('meta.json'),
-    search,
-    character,
-    record:catalog.get,
-    item:catalog.item,
-    map:catalog.map,
-    // live player endpoints remain under api.* to distinguish local records
-    getPlayerStats:fullApi.profileStats
-  });
-}
-module.exports={createTracker:createWarframeTracker,TrackerError};
+'use strict';
+const provider=require('./provider');
+const {createWarframeClient,parameter,optionsQuery}=require('./warframe-client');
+const {createDataStore}=require('./data-store');
+const {createCatalog}=require('./catalog');
+const {createWarframeCodes}=require('./warframe-codes');
+const {createWFCD,createMarketQuery,createUpdateMonitor}=require('./wfcd');
+const {TrackerError}=require('./client-error');
+
+const itemTypes=new Set(['warframes','weapons','items','mods']);
+const id=v=>parameter(v,'identifier');
+function platformOf(value) {
+  const p=value||'pc';
+  if(!provider.platforms.includes(p))throw new RangeError('Unsupported platform '+p);
+  return p;
+}
+function createWarframeTracker({platform='pc',language='en',timeoutMs=15000,cacheDir,githubToken,fetchImpl}={}) {
+  const selected=platformOf(platform);
+  const {request}=createWarframeClient({language,timeoutMs,fetchImpl});
+  const data=createDataStore({
+    gameId:'warframe', github:{owner:'NekoSuneProjectsNPM',repo:'game-tracker',branch:'JsonData',directory:'games/warframe'},
+    bundledDir:require('node:path').join(__dirname,'..','data'),
+    cacheDir, githubToken, fetchImpl
+  });
+  const catalog=createCatalog(data);
+  // Local-first: only query GitHub if a requested character is absent.
+  // Existing bundled and cached characters work without any network call.
+  async function character(name, options = {}) {
+    try { return await catalog.character(name); }
+    catch (err) {
+      if (err.code !== 'NOT_FOUND') throw err;
+      if (options.refresh === false) throw err;
+      await data.sync({ signal: options.signal });
+      return catalog.character(name);
+    }
+  }
+  // Set refresh:true to discover new records that didn't exist in local JSON.
+  async function search(query, options = {}) {
+    if (options.refresh === true) await data.sync({ signal: options.signal });
+    return catalog.search(query, options);
+  }
+  const codes=createWarframeCodes({cacheDir,githubToken,fetchImpl});
+  const wfcd=createWFCD({cacheDir,githubToken,fetchImpl});
+  const worldstate=(field,options={})=>{
+    if(typeof field!=='string' || !/^[a-zA-Z][a-zA-Z0-9]*$/.test(field)) throw new TypeError('Invalid worldstate field');
+    return request(selected+'/'+field,optionsQuery(options,['filter']));
+  };
+  const listing=(kind,options={})=>{
+    if(!itemTypes.has(kind))throw new RangeError('Unknown item type');
+    return request(kind,optionsQuery(options,['language','filter','only','remove']));
+  };
+  const single=(kind,name,options={})=>{
+    if(!itemTypes.has(kind))throw new RangeError('Unknown item type');
+    return request(kind+'/'+id(name),optionsQuery(options,['language','filter','only','remove','by']));
+  };
+  const find=(kind,query,options={})=>{
+    if(!itemTypes.has(kind))throw new RangeError('Unknown item type');
+    return request(kind+'/search/'+id(query),optionsQuery(options,['language','filter','only','remove','by']));
+  };
+  const api=Object.freeze({
+    health:()=>request('health'),
+    worldstate:()=>request(selected),
+    worldstateField:(field,options)=>worldstate(field,options),
+    profile:(playerId,options)=>request('profile/'+id(playerId),optionsQuery(options,['language','withItem'])),
+    profileStats:playerId=>request('profile/'+id(playerId)+'/stats'),
+    profileXP:(playerId,options)=>request('profile/'+id(playerId)+'/xpInfo',optionsQuery(options,['withItem'])),
+    list:listing,
+    get:single,
+    search:find,
+    warframes:options=>listing('warframes',options),
+    weapons:options=>listing('weapons',options),
+    items:options=>listing('items',options),
+    mods:options=>listing('mods',options),
+    warframe:(name,options)=>single('warframes',name,options),
+    weapon:(name,options)=>single('weapons',name,options),
+    item:(name,options)=>single('items',name,options),
+    mod:(name,options)=>single('mods',name,options),
+    searchWarframes:(q,options)=>find('warframes',q,options),
+    searchWeapons:(q,options)=>find('weapons',q,options),
+    searchItems:(q,options)=>find('items',q,options),
+    searchMods:(q,options)=>find('mods',q,options),
+    drops:()=>request('drops'),
+    searchDrops:(query,options)=>request('drops/search/'+id(query),optionsQuery(options,['grouped_by'])),
+    rivens:()=>request(selected+'/rivens'),
+    searchRivens:query=>request(selected+'/rivens/search/'+id(query)),
+    staticData:(key,options)=>request(id(key),optionsQuery(options,['language'])),
+    searchStatic:(key,query,options)=>request(id(key)+'/search/'+id(query),optionsQuery(options,['language'])),
+    synthTargets:options=>request('synthTargets',optionsQuery(options,['language'])),
+    arcanes:options=>request('arcanes',optionsQuery(options,['language'])),
+    rss:()=>request('rss'),
+    twitter:()=>request('twitter'),
+    wfinfoFilteredItems:()=>request('wfinfo/filtered_items'),
+    wfinfoPrices:()=>request('wfinfo/prices')
+  });
+  const fields=Object.fromEntries(provider.worldstateFields.filter(k=>!Object.hasOwn(api,k)).map(k=>[k,options=>worldstate(k,options)]));
+  const fullApi=Object.freeze({...api,...fields});
+  return Object.freeze({
+    api:fullApi,
+    data,
+    codes,
+    wfcd,
+    market:createMarketQuery,
+    createUpdateMonitor,
+    code:codes.get,
+    About:()=>data.get('meta.json'),
+    search,
+    character,
+    record:catalog.get,
+    item:catalog.item,
+    map:catalog.map,
+    // live player endpoints remain under api.* to distinguish local records
+    getPlayerStats:fullApi.profileStats
+  });
+}
+module.exports={createTracker:createWarframeTracker,TrackerError};