@nekosuneprojects/warframe-api 1.0.0 → 1.0.1

package/src/warframe-client.js

@@ -1,57 +1,57 @@
-'use strict';
-const { TrackerError } = require('./client-error');
-const provider = require('./provider');
-
-function parameter(value, name) {
-  if (typeof value !== 'string' || !value.trim()) throw new TypeError(name + ' must be nonempty text');
-  return encodeURIComponent(value.trim());
-}
-function optionsQuery(options, allowed) {
-  if (options === undefined || options === null) return undefined;
-  if (typeof options !== 'object' || Array.isArray(options)) throw new TypeError('Options must be an object');
-  const params = {};
-  for (const [key,value] of Object.entries(options)) {
-    if (!allowed.includes(key)) throw new TypeError('Unsupported query option: ' + key);
-    if (value !== undefined && value !== null) {
-      if (!['string','number','boolean'].includes(typeof value)) throw new TypeError('Invalid query option: ' + key);
-      params[key]=String(value);
-    }
-  }
-  return params;
-}
-function createWarframeClient({ timeoutMs = 15000, fetchImpl = globalThis.fetch, language = 'en' } = {}) {
-  if (typeof fetchImpl !== 'function') throw new TypeError('Node.js 18+ fetch is required');
-  if (!Number.isInteger(timeoutMs) || timeoutMs < 1) throw new TypeError('timeoutMs must be a positive integer');
-  if (typeof language !== 'string' || !/^[a-z]{2}$/.test(language)) throw new TypeError('language must be a 2-letter code');
-  async function request(route, query, { signal } = {}) {
-    if (typeof route !== 'string' || !/^[a-zA-Z0-9_/%.-]+$/.test(route) || route.startsWith('/'))
-      throw new TypeError('Invalid internal API route');
-    const url = new URL(route, provider.baseUrl);
-    if (url.origin !== new URL(provider.baseUrl).origin) throw new TypeError('API origin mismatch');
-    for (const [k,v] of Object.entries(query || {})) url.searchParams.set(k,String(v));
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(),timeoutMs);
-    const onAbort = () => controller.abort();
-    if (signal) {
-      if (signal.aborted) controller.abort();
-      else signal.addEventListener('abort',onAbort,{once:true});
-    }
-    try {
-      const response = await fetchImpl(url,{
-        headers:{Accept:'application/json','Accept-Language':language,'User-Agent':'nekosuneprojects-warframe-api'},
-        signal:controller.signal
-      });
-      if (!response.ok) throw new TrackerError('WarframeStat.us HTTP '+response.status,{status:response.status});
-      if (response.status===204) return null;
-      return await response.json();
-    } catch (cause) {
-      if (cause instanceof TrackerError) throw cause;
-      throw new TrackerError('WarframeStat.us request failed',{cause});
-    } finally {
-      clearTimeout(timer);
-      if (signal) signal.removeEventListener('abort',onAbort);
-    }
-  }
-  return Object.freeze({request,parameter,optionsQuery});
-}
-module.exports={createWarframeClient,parameter,optionsQuery};
+'use strict';
+const { TrackerError } = require('./client-error');
+const provider = require('./provider');
+
+function parameter(value, name) {
+  if (typeof value !== 'string' || !value.trim()) throw new TypeError(name + ' must be nonempty text');
+  return encodeURIComponent(value.trim());
+}
+function optionsQuery(options, allowed) {
+  if (options === undefined || options === null) return undefined;
+  if (typeof options !== 'object' || Array.isArray(options)) throw new TypeError('Options must be an object');
+  const params = {};
+  for (const [key,value] of Object.entries(options)) {
+    if (!allowed.includes(key)) throw new TypeError('Unsupported query option: ' + key);
+    if (value !== undefined && value !== null) {
+      if (!['string','number','boolean'].includes(typeof value)) throw new TypeError('Invalid query option: ' + key);
+      params[key]=String(value);
+    }
+  }
+  return params;
+}
+function createWarframeClient({ timeoutMs = 15000, fetchImpl = globalThis.fetch, language = 'en' } = {}) {
+  if (typeof fetchImpl !== 'function') throw new TypeError('Node.js 18+ fetch is required');
+  if (!Number.isInteger(timeoutMs) || timeoutMs < 1) throw new TypeError('timeoutMs must be a positive integer');
+  if (typeof language !== 'string' || !/^[a-z]{2}$/.test(language)) throw new TypeError('language must be a 2-letter code');
+  async function request(route, query, { signal } = {}) {
+    if (typeof route !== 'string' || !/^[a-zA-Z0-9_/%.-]+$/.test(route) || route.startsWith('/'))
+      throw new TypeError('Invalid internal API route');
+    const url = new URL(route, provider.baseUrl);
+    if (url.origin !== new URL(provider.baseUrl).origin) throw new TypeError('API origin mismatch');
+    for (const [k,v] of Object.entries(query || {})) url.searchParams.set(k,String(v));
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(),timeoutMs);
+    const onAbort = () => controller.abort();
+    if (signal) {
+      if (signal.aborted) controller.abort();
+      else signal.addEventListener('abort',onAbort,{once:true});
+    }
+    try {
+      const response = await fetchImpl(url,{
+        headers:{Accept:'application/json','Accept-Language':language,'User-Agent':'nekosuneprojects-warframe-api'},
+        signal:controller.signal
+      });
+      if (!response.ok) throw new TrackerError('WarframeStat.us HTTP '+response.status,{status:response.status});
+      if (response.status===204) return null;
+      return await response.json();
+    } catch (cause) {
+      if (cause instanceof TrackerError) throw cause;
+      throw new TrackerError('WarframeStat.us request failed',{cause});
+    } finally {
+      clearTimeout(timer);
+      if (signal) signal.removeEventListener('abort',onAbort);
+    }
+  }
+  return Object.freeze({request,parameter,optionsQuery});
+}
+module.exports={createWarframeClient,parameter,optionsQuery};

package/src/warframe-codes.js

@@ -1,82 +1,82 @@
-'use strict';
-const path = require('node:path');
-const { createDataStore } = require('./data-store');
-
-const FILE = 'warframe.json';
-const GROUPS = Object.freeze({ active:'Active', expired:'Expired', unknown:'Unknown' });
-const normalise = text => String(text ?? '').normalize('NFKC').trim().toLowerCase();
-function validate(source) {
-  if (!source || typeof source !== 'object' || Array.isArray(source) ||
-      !Object.values(GROUPS).every(group => Array.isArray(source[group]))) {
-    throw new TypeError('Invalid Warframe codes JSON: Active, Expired and Unknown arrays are required');
-  }
-  return source;
-}
-function createWarframeCodes({cacheDir,githubToken,fetchImpl}={}) {
-  const storage = createDataStore({
-    gameId:'warframe-codes',
-    cacheDir:cacheDir ? path.join(path.resolve(cacheDir),'codes') : undefined,
-    bundledDir:path.join(__dirname,'..','data','codes'),
-    github:{owner:'NekoSuneProjectsNPM',repo:'game-tracker',branch:'JsonData',directory:'codes/games'},
-    syncFiles:[FILE],
-    githubToken,fetchImpl
-  });
-  async function raw() { return validate(await storage.get(FILE)); }
-  async function list({status,category,claimType,hasCode,limit}={}) {
-    if (status !== undefined && !Object.hasOwn(GROUPS,status)) throw new RangeError('status must be active, expired, or unknown');
-    if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) throw new RangeError('limit must be a positive integer');
-    const doc=await raw();
-    const keys=status ? [GROUPS[status]] : Object.values(GROUPS);
-    let entries=keys.flatMap(key=>doc[key]);
-    if (category !== undefined) entries=entries.filter(item=>normalise(item.category)===normalise(category));
-    if (claimType !== undefined) entries=entries.filter(item=>normalise(item.claimType)===normalise(claimType));
-    if (hasCode !== undefined) {
-      if (typeof hasCode !== 'boolean') throw new TypeError('hasCode must be boolean');
-      entries=entries.filter(item=>Boolean(typeof item.code==='string'&&item.code.trim())===hasCode);
-    }
-    return limit ? entries.slice(0,limit) : entries;
-  }
-  async function search(query,options={}) {
-    if(typeof query!=='string'||!query.trim()) throw new TypeError('Search query is required');
-    const needle=normalise(query);
-    const entries=await list(options);
-    const results=entries.filter(record=>{
-      const fields=[record.code,record.id,record.category,record.claimType,record.notes,record.redeemLocation,
-        ...(Array.isArray(record.items)?record.items.map(item=>item?.name):[])];
-      return fields.some(value=>normalise(value).includes(needle));
-    });
-    return {query,total:results.length,results,message:results.length?
-      'Found '+results.length+' Warframe code-related entries for "'+query+'".':
-      'We don\'t have anything related to "'+query+'" in Warframe codes.'};
-  }
-  async function get(key) {
-    if((typeof key!=='string' && typeof key!=='number') || !String(key).trim()) throw new TypeError('Code or ID is required');
-    const needle=normalise(key);
-    const results=(await list()).filter(item=>normalise(item.id)===needle || (item.code && normalise(item.code)===needle));
-    if(results.length===0) {
-      const err=new Error('No Warframe code entry found: '+key); err.code='NOT_FOUND';throw err;
-    }
-    if(results.length>1) {
-      const err=new Error('Multiple Warframe code entries match: '+key);err.code='AMBIGUOUS';err.results=results;throw err;
-    }
-    return results[0];
-  }
-  async function summary() {
-    const doc=await raw(); const groups={};let total=0;let redeemable=0;
-    for(const [status,key] of Object.entries(GROUPS)) {
-      const entries=doc[key];
-      const withCode=entries.filter(item=>typeof item.code==='string' && item.code.trim()).length;
-      groups[status]={total:entries.length,withCode,withoutCode:entries.length-withCode};
-      total+=entries.length;redeemable+=withCode;
-    }
-    return {total,withCode:redeemable,withoutCode:total-redeemable,groups};
-  }
-  return Object.freeze({
-    raw,list,active:options=>list({...options,status:'active'}),
-    expired:options=>list({...options,status:'expired'}),
-    unknown:options=>list({...options,status:'unknown'}),
-    search,get,summary,sync:options=>storage.sync(options),
-    cacheDir:storage.cacheDir
-  });
-}
-module.exports={createWarframeCodes};
+'use strict';
+const path = require('node:path');
+const { createDataStore } = require('./data-store');
+
+const FILE = 'warframe.json';
+const GROUPS = Object.freeze({ active:'Active', expired:'Expired', unknown:'Unknown' });
+const normalise = text => String(text ?? '').normalize('NFKC').trim().toLowerCase();
+function validate(source) {
+  if (!source || typeof source !== 'object' || Array.isArray(source) ||
+      !Object.values(GROUPS).every(group => Array.isArray(source[group]))) {
+    throw new TypeError('Invalid Warframe codes JSON: Active, Expired and Unknown arrays are required');
+  }
+  return source;
+}
+function createWarframeCodes({cacheDir,githubToken,fetchImpl}={}) {
+  const storage = createDataStore({
+    gameId:'warframe-codes',
+    cacheDir:cacheDir ? path.join(path.resolve(cacheDir),'codes') : undefined,
+    bundledDir:path.join(__dirname,'..','data','codes'),
+    github:{owner:'NekoSuneProjectsNPM',repo:'game-tracker',branch:'JsonData',directory:'codes/games'},
+    syncFiles:[FILE],
+    githubToken,fetchImpl
+  });
+  async function raw() { return validate(await storage.get(FILE)); }
+  async function list({status,category,claimType,hasCode,limit}={}) {
+    if (status !== undefined && !Object.hasOwn(GROUPS,status)) throw new RangeError('status must be active, expired, or unknown');
+    if (limit !== undefined && (!Number.isInteger(limit) || limit < 1)) throw new RangeError('limit must be a positive integer');
+    const doc=await raw();
+    const keys=status ? [GROUPS[status]] : Object.values(GROUPS);
+    let entries=keys.flatMap(key=>doc[key]);
+    if (category !== undefined) entries=entries.filter(item=>normalise(item.category)===normalise(category));
+    if (claimType !== undefined) entries=entries.filter(item=>normalise(item.claimType)===normalise(claimType));
+    if (hasCode !== undefined) {
+      if (typeof hasCode !== 'boolean') throw new TypeError('hasCode must be boolean');
+      entries=entries.filter(item=>Boolean(typeof item.code==='string'&&item.code.trim())===hasCode);
+    }
+    return limit ? entries.slice(0,limit) : entries;
+  }
+  async function search(query,options={}) {
+    if(typeof query!=='string'||!query.trim()) throw new TypeError('Search query is required');
+    const needle=normalise(query);
+    const entries=await list(options);
+    const results=entries.filter(record=>{
+      const fields=[record.code,record.id,record.category,record.claimType,record.notes,record.redeemLocation,
+        ...(Array.isArray(record.items)?record.items.map(item=>item?.name):[])];
+      return fields.some(value=>normalise(value).includes(needle));
+    });
+    return {query,total:results.length,results,message:results.length?
+      'Found '+results.length+' Warframe code-related entries for "'+query+'".':
+      'We don\'t have anything related to "'+query+'" in Warframe codes.'};
+  }
+  async function get(key) {
+    if((typeof key!=='string' && typeof key!=='number') || !String(key).trim()) throw new TypeError('Code or ID is required');
+    const needle=normalise(key);
+    const results=(await list()).filter(item=>normalise(item.id)===needle || (item.code && normalise(item.code)===needle));
+    if(results.length===0) {
+      const err=new Error('No Warframe code entry found: '+key); err.code='NOT_FOUND';throw err;
+    }
+    if(results.length>1) {
+      const err=new Error('Multiple Warframe code entries match: '+key);err.code='AMBIGUOUS';err.results=results;throw err;
+    }
+    return results[0];
+  }
+  async function summary() {
+    const doc=await raw(); const groups={};let total=0;let redeemable=0;
+    for(const [status,key] of Object.entries(GROUPS)) {
+      const entries=doc[key];
+      const withCode=entries.filter(item=>typeof item.code==='string' && item.code.trim()).length;
+      groups[status]={total:entries.length,withCode,withoutCode:entries.length-withCode};
+      total+=entries.length;redeemable+=withCode;
+    }
+    return {total,withCode:redeemable,withoutCode:total-redeemable,groups};
+  }
+  return Object.freeze({
+    raw,list,active:options=>list({...options,status:'active'}),
+    expired:options=>list({...options,status:'expired'}),
+    unknown:options=>list({...options,status:'unknown'}),
+    search,get,summary,sync:options=>storage.sync(options),
+    cacheDir:storage.cacheDir
+  });
+}
+module.exports={createWarframeCodes};

package/src/wfcd.js

@@ -1,93 +1,93 @@
-'use strict';
-const fs = require('node:fs/promises');
-const path = require('node:path');
-const os = require('node:os');
-const crypto = require('node:crypto');
-
-// Verified WFCD GitHub repositories. All URLs are internal, never caller-provided.
-const SOURCES = Object.freeze({
-  drops:{repo:'warframe-drop-data',branch:'main',prefix:'data/',files:['all.json','info.json','missionRewards.json','relics.json','modLocations.json','blueprintLocations.json','cetusBountyRewards.json','solarisBountyRewards.json','sortieRewards.json','transientRewards.json','deimosRewards.json','entratiLabRewards.json','hexRewards.json','zarimanRewards.json','syndicates.json']},
-  items:{repo:'warframe-items',branch:'master',prefix:'data/json/',files:['Arcanes.json','Arch-Gun.json','Arch-Melee.json','Archwing.json','Components.json','Enemy.json','Fish.json','Gear.json','Glyphs.json','Honoria.json','Melee.json','Misc.json','Mods.json','Node.json','Pets.json','Primary.json','Quests.json','Railjack.json','Relics.json','Resources.json','Secondary.json','SentinelWeapons.json','Sentinels.json','Sigils.json','Skins.json','Warframes.json']},
-  relics:{repo:'warframe-relic-data',branch:'development',prefix:'data/',files:['Relics.json','Relics.min.json','hash.json','version.json']},
-  patchlogs:{repo:'warframe-patchlogs',branch:'master',prefix:'data/',files:['patchlogs.json']}
-});
-const FILE_LIMIT = 16 * 1024 * 1024;
-function createWFCD({cacheDir,githubToken,fetchImpl=globalThis.fetch}={}){
-  if(typeof fetchImpl!=='function')throw new TypeError('fetch is required');
-  const root=path.resolve(cacheDir || path.join(os.homedir(),'.cache','nekosune-game-tracker','warframe'),'wfcd');
-  const headers={Accept:'application/vnd.github+json','User-Agent':'nekosuneprojects-warframe-api',...(githubToken?{Authorization:'Bearer '+githubToken}:{})};
-  const sha=buffer=>crypto.createHash('sha1').update('blob '+buffer.length+'\0').update(buffer).digest('hex');
-  async function get(source,name,{refresh=false,signal}={}){
-    const definition=SOURCES[source];
-    if(!definition)throw new RangeError('Unknown WFCD data source');
-    if(typeof name!=='string'||!definition.files.includes(name))throw new RangeError('Unsupported '+source+' JSON file');
-    const dest=path.join(root,source,name);
-    const manifest=dest+'.sha';
-    let local;
-    try{local=await fs.readFile(dest);JSON.parse(local.toString('utf8'))}
-    catch(error){if(error.code!=='ENOENT' && !(error instanceof SyntaxError))throw error;local=null}
-    if(local && !refresh)return JSON.parse(local.toString('utf8'));
-    const remotePath=definition.prefix+name;
-    const contentsUrl='https://api.github.com/repos/WFCD/'+definition.repo+'/contents/'+remotePath+'?ref='+definition.branch;
-    try {
-      const metadataResponse=await fetchImpl(contentsUrl,{headers,signal});
-      if(!metadataResponse.ok)throw new Error('WFCD metadata HTTP '+metadataResponse.status);
-      const metadata=await metadataResponse.json();
-      if(!/^[a-f0-9]{40}$/.test(metadata.sha||'') || metadata.type!=='file' ||
-         !Number.isSafeInteger(metadata.size) || metadata.size>FILE_LIMIT)throw new Error('Invalid WFCD source metadata');
-      if(local && sha(local)===metadata.sha)return JSON.parse(local.toString('utf8'));
-      const blobURL='https://api.github.com/repos/WFCD/'+definition.repo+'/git/blobs/'+metadata.sha;
-      const response=await fetchImpl(blobURL,{headers,signal});
-      if(!response.ok)throw new Error('WFCD blob HTTP '+response.status);
-      const blob=await response.json();
-      if(blob.encoding!=='base64'||typeof blob.content!=='string')throw new Error('Unexpected WFCD blob encoding');
-      const body=Buffer.from(blob.content.replace(/\s/g,''),'base64');
-      if(body.length>FILE_LIMIT||sha(body)!==metadata.sha)throw new Error('WFCD checksum/size mismatch');
-      const value=JSON.parse(body.toString('utf8'));
-      await fs.mkdir(path.dirname(dest),{recursive:true});
-      const tmp=dest+'.'+process.pid+'.'+crypto.randomBytes(6).toString('hex')+'.tmp';
-      try{await fs.writeFile(tmp,body);await fs.rename(tmp,dest);await fs.writeFile(manifest,metadata.sha)}
-      finally{await fs.rm(tmp,{force:true})}
-      return value;
-    } catch(error) {
-      if(local && !refresh)return JSON.parse(local.toString('utf8'));
-      throw error;
-    }
-  }
-  const groups=Object.fromEntries(Object.keys(SOURCES).map(source=>[source,Object.freeze({
-    files:Object.freeze([...SOURCES[source].files]),
-    get:(name,options)=>get(source,name,options),
-    refresh:(name,options)=>get(source,name,{...options,refresh:true}),
-    ...(source==='drops'?{all:opts=>get(source,'all.json',opts),info:opts=>get(source,'info.json',opts),
-      missionRewards:opts=>get(source,'missionRewards.json',opts)}:{}),
-    ...(source==='items'?{warframes:opts=>get(source,'Warframes.json',opts),
-      weapons:opts=>Promise.all(['Primary.json','Secondary.json','Melee.json'].map(name=>get(source,name,opts))).then(parts=>parts.flat()),
-      mods:opts=>get(source,'Mods.json',opts),arcanes:opts=>get(source,'Arcanes.json',opts)}:{}),
-    ...(source==='relics'?{all:opts=>get(source,'Relics.json',opts)}:{}),
-    ...(source==='patchlogs'?{all:opts=>get(source,'patchlogs.json',opts)}:{})
-  })]));
-  return Object.freeze({...groups,cacheDir:root});
-}
-
-async function createMarketQuery(options={}) {
-  let pkg;
-  try {pkg=await import('warframe-nexus-query');}
-  catch(error) {
-    if(error.code==='ERR_MODULE_NOT_FOUND')throw new Error('Install optional market integration: npm install warframe-nexus-query',{cause:error});
-    throw error;
-  }
-  const Constructor=pkg.default||pkg.PriceCheckQuerier;
-  if(typeof Constructor!=='function')throw new Error('Unsupported warframe-nexus-query export');
-  return new Constructor(options);
-}
-function createUpdateMonitor(options={}){
-  let Package;
-  try{Package=require('warframe-updates')}
-  catch(error){
-    if(error.code==='MODULE_NOT_FOUND')throw new Error('Install optional patch monitor: npm install warframe-updates',{cause:error});
-    throw error;
-  }
-  if(typeof Package!=='function')throw new Error('Unsupported warframe-updates export');
-  return new Package(options);
-}
-module.exports={createWFCD,createMarketQuery,createUpdateMonitor,SOURCES};
+'use strict';
+const fs = require('node:fs/promises');
+const path = require('node:path');
+const os = require('node:os');
+const crypto = require('node:crypto');
+
+// Verified WFCD GitHub repositories. All URLs are internal, never caller-provided.
+const SOURCES = Object.freeze({
+  drops:{repo:'warframe-drop-data',branch:'main',prefix:'data/',files:['all.json','info.json','missionRewards.json','relics.json','modLocations.json','blueprintLocations.json','cetusBountyRewards.json','solarisBountyRewards.json','sortieRewards.json','transientRewards.json','deimosRewards.json','entratiLabRewards.json','hexRewards.json','zarimanRewards.json','syndicates.json']},
+  items:{repo:'warframe-items',branch:'master',prefix:'data/json/',files:['Arcanes.json','Arch-Gun.json','Arch-Melee.json','Archwing.json','Components.json','Enemy.json','Fish.json','Gear.json','Glyphs.json','Honoria.json','Melee.json','Misc.json','Mods.json','Node.json','Pets.json','Primary.json','Quests.json','Railjack.json','Relics.json','Resources.json','Secondary.json','SentinelWeapons.json','Sentinels.json','Sigils.json','Skins.json','Warframes.json']},
+  relics:{repo:'warframe-relic-data',branch:'development',prefix:'data/',files:['Relics.json','Relics.min.json','hash.json','version.json']},
+  patchlogs:{repo:'warframe-patchlogs',branch:'master',prefix:'data/',files:['patchlogs.json']}
+});
+const FILE_LIMIT = 16 * 1024 * 1024;
+function createWFCD({cacheDir,githubToken,fetchImpl=globalThis.fetch}={}){
+  if(typeof fetchImpl!=='function')throw new TypeError('fetch is required');
+  const root=path.resolve(cacheDir || path.join(os.homedir(),'.cache','nekosune-game-tracker','warframe'),'wfcd');
+  const headers={Accept:'application/vnd.github+json','User-Agent':'nekosuneprojects-warframe-api',...(githubToken?{Authorization:'Bearer '+githubToken}:{})};
+  const sha=buffer=>crypto.createHash('sha1').update('blob '+buffer.length+'\0').update(buffer).digest('hex');
+  async function get(source,name,{refresh=false,signal}={}){
+    const definition=SOURCES[source];
+    if(!definition)throw new RangeError('Unknown WFCD data source');
+    if(typeof name!=='string'||!definition.files.includes(name))throw new RangeError('Unsupported '+source+' JSON file');
+    const dest=path.join(root,source,name);
+    const manifest=dest+'.sha';
+    let local;
+    try{local=await fs.readFile(dest);JSON.parse(local.toString('utf8'))}
+    catch(error){if(error.code!=='ENOENT' && !(error instanceof SyntaxError))throw error;local=null}
+    if(local && !refresh)return JSON.parse(local.toString('utf8'));
+    const remotePath=definition.prefix+name;
+    const contentsUrl='https://api.github.com/repos/WFCD/'+definition.repo+'/contents/'+remotePath+'?ref='+definition.branch;
+    try {
+      const metadataResponse=await fetchImpl(contentsUrl,{headers,signal});
+      if(!metadataResponse.ok)throw new Error('WFCD metadata HTTP '+metadataResponse.status);
+      const metadata=await metadataResponse.json();
+      if(!/^[a-f0-9]{40}$/.test(metadata.sha||'') || metadata.type!=='file' ||
+         !Number.isSafeInteger(metadata.size) || metadata.size>FILE_LIMIT)throw new Error('Invalid WFCD source metadata');
+      if(local && sha(local)===metadata.sha)return JSON.parse(local.toString('utf8'));
+      const blobURL='https://api.github.com/repos/WFCD/'+definition.repo+'/git/blobs/'+metadata.sha;
+      const response=await fetchImpl(blobURL,{headers,signal});
+      if(!response.ok)throw new Error('WFCD blob HTTP '+response.status);
+      const blob=await response.json();
+      if(blob.encoding!=='base64'||typeof blob.content!=='string')throw new Error('Unexpected WFCD blob encoding');
+      const body=Buffer.from(blob.content.replace(/\s/g,''),'base64');
+      if(body.length>FILE_LIMIT||sha(body)!==metadata.sha)throw new Error('WFCD checksum/size mismatch');
+      const value=JSON.parse(body.toString('utf8'));
+      await fs.mkdir(path.dirname(dest),{recursive:true});
+      const tmp=dest+'.'+process.pid+'.'+crypto.randomBytes(6).toString('hex')+'.tmp';
+      try{await fs.writeFile(tmp,body);await fs.rename(tmp,dest);await fs.writeFile(manifest,metadata.sha)}
+      finally{await fs.rm(tmp,{force:true})}
+      return value;
+    } catch(error) {
+      if(local && !refresh)return JSON.parse(local.toString('utf8'));
+      throw error;
+    }
+  }
+  const groups=Object.fromEntries(Object.keys(SOURCES).map(source=>[source,Object.freeze({
+    files:Object.freeze([...SOURCES[source].files]),
+    get:(name,options)=>get(source,name,options),
+    refresh:(name,options)=>get(source,name,{...options,refresh:true}),
+    ...(source==='drops'?{all:opts=>get(source,'all.json',opts),info:opts=>get(source,'info.json',opts),
+      missionRewards:opts=>get(source,'missionRewards.json',opts)}:{}),
+    ...(source==='items'?{warframes:opts=>get(source,'Warframes.json',opts),
+      weapons:opts=>Promise.all(['Primary.json','Secondary.json','Melee.json'].map(name=>get(source,name,opts))).then(parts=>parts.flat()),
+      mods:opts=>get(source,'Mods.json',opts),arcanes:opts=>get(source,'Arcanes.json',opts)}:{}),
+    ...(source==='relics'?{all:opts=>get(source,'Relics.json',opts)}:{}),
+    ...(source==='patchlogs'?{all:opts=>get(source,'patchlogs.json',opts)}:{})
+  })]));
+  return Object.freeze({...groups,cacheDir:root});
+}
+
+async function createMarketQuery(options={}) {
+  let pkg;
+  try {pkg=await import('warframe-nexus-query');}
+  catch(error) {
+    if(error.code==='ERR_MODULE_NOT_FOUND')throw new Error('Install optional market integration: npm install warframe-nexus-query',{cause:error});
+    throw error;
+  }
+  const Constructor=pkg.default||pkg.PriceCheckQuerier;
+  if(typeof Constructor!=='function')throw new Error('Unsupported warframe-nexus-query export');
+  return new Constructor(options);
+}
+function createUpdateMonitor(options={}){
+  let Package;
+  try{Package=require('warframe-updates')}
+  catch(error){
+    if(error.code==='MODULE_NOT_FOUND')throw new Error('Install optional patch monitor: npm install warframe-updates',{cause:error});
+    throw error;
+  }
+  if(typeof Package!=='function')throw new Error('Unsupported warframe-updates export');
+  return new Package(options);
+}
+module.exports={createWFCD,createMarketQuery,createUpdateMonitor,SOURCES};