npm - @lgriffin/esi.ts - Versions diffs - 1.0.0 → 2.0.0 - Mend

@lgriffin/esi.ts 1.0.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1152) hide show

package/docs/index.html ADDED Viewed

@@ -0,0 +1,272 @@
+<!DOCTYPE html><html class="default" lang="en"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>@lgriffin/esi.ts - EVE Online ESI API Client - v1.0.0</title><meta name="description" content="Documentation for @lgriffin/esi.ts - EVE Online ESI API Client"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="assets/style.css"/><link rel="stylesheet" href="assets/highlight.css"/><script defer src="assets/main.js"></script><script async src="assets/icons.js" id="tsd-icons-script"></script><script async src="assets/search.js" id="tsd-search-script"></script><script async src="assets/navigation.js" id="tsd-nav-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><div class="table-cell" id="tsd-search" data-base="."><div class="field"><label for="tsd-search-field" class="tsd-widget tsd-toolbar-icon search no-caption"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="assets/icons.svg#icon-search"></use></svg></label><input type="text" id="tsd-search-field" aria-label="Search"/></div><div class="field"><div id="tsd-toolbar-links"><a href="https://github.com/lgriffin/ESI.ts">GitHub</a><a href="https://www.npmjs.com/package/@lgriffin/esi.ts">NPM</a></div></div><ul class="results"><li class="state loading">Preparing search index...</li><li class="state failure">The search index is not available</li></ul><a href="https://github.com/lgriffin/ESI.ts" class="title">@lgriffin/esi.ts - EVE Online ESI API Client - v1.0.0</a></div><div class="table-cell" id="tsd-widgets"><a href="#" class="tsd-widget tsd-toolbar-icon menu no-caption" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none"><use href="assets/icons.svg#icon-menu"></use></svg></a></div></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><h1>@lgriffin/esi.ts - EVE Online ESI API Client - v1.0.0</h1></div><div class="tsd-panel tsd-typography"><a id="md:esits" class="tsd-anchor"></a><h1 class="tsd-anchor-link">ESI.ts<a href="#md:esits" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h1><p><a href="https://badge.fury.io/js/%40lgriffin%2Fesi.ts" target="_blank" class="external"><img src="https://badge.fury.io/js/%40lgriffin%2Fesi.ts.svg" alt="npm version"></a>
+<a href="https://www.gnu.org/licenses/gpl-3.0" target="_blank" class="external"><img src="https://img.shields.io/badge/License-GPLv3-blue.svg" alt="License: GPL v3"></a>
+<a href="https://www.typescriptlang.org/" target="_blank" class="external"><img src="https://img.shields.io/badge/TypeScript-4.5%2B-blue" alt="TypeScript"></a></p>
+<p>A modern, type-safe TypeScript implementation for the <a href="https://esi.evetech.net/" target="_blank" class="external">EVE Online ESI API</a>. Built with clean architecture principles, comprehensive error handling, and extensive testing.</p>
+<a id="md:🚀-features" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🚀 Features<a href="#md:🚀-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><ul>
+<li><strong>Type-Safe</strong>: Full TypeScript support with comprehensive type definitions</li>
+<li><strong>Clean Architecture</strong>: Separation of concerns with dependency injection</li>
+<li><strong>Resilient</strong>: Built-in error handling, retry logic, and circuit breakers</li>
+<li><strong>High Performance</strong>: Intelligent ETag caching for optimal bandwidth usage</li>
+<li><strong>Testable</strong>: Extensive test coverage with BDD scenarios</li>
+<li><strong>Modern</strong>: Uses latest TypeScript features and best practices</li>
+<li><strong>Comprehensive</strong>: Covers all ESI API endpoints with organized client structure</li>
+</ul>
+<a id="md:📦-installation" class="tsd-anchor"></a><h2 class="tsd-anchor-link">📦 Installation<a href="#md:📦-installation" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><pre><code class="bash"><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">install</span><span class="hl-1"> </span><span class="hl-2">@lgriffin/esi.ts</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:🔧-getting-started" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🔧 Getting Started<a href="#md:🔧-getting-started" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>ESI.ts offers multiple ways to use the API depending on your needs:</p>
+<a id="md:1-full-esi-client-all-apis" class="tsd-anchor"></a><h3 class="tsd-anchor-link">1. Full ESI Client (All APIs)<a href="#md:1-full-esi-client-all-apis" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The complete <code>EsiClient</code> gives you access to all ESI endpoints:</p>
+<pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiClient</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// Full client with all APIs available</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;your-app-name&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">accessToken:</span><span class="hl-1"> </span><span class="hl-2">&#39;your-access-token&#39;</span><span class="hl-1">, </span><span class="hl-5">// Optional - required for authenticated endpoints</span><br/><span class="hl-1">  </span><span class="hl-4">timeout:</span><span class="hl-1"> </span><span class="hl-8">30000</span><span class="hl-1">,                   </span><span class="hl-5">// Optional - request timeout in ms</span><br/><span class="hl-1">  </span><span class="hl-4">retryAttempts:</span><span class="hl-1"> </span><span class="hl-8">3</span><span class="hl-1">                  </span><span class="hl-5">// Optional - number of retry attempts</span><br/><span class="hl-1">});</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:2-custom-lightweight-client-selected-apis" class="tsd-anchor"></a><h3 class="tsd-anchor-link">2. Custom Lightweight Client (Selected APIs)<a href="#md:2-custom-lightweight-client-selected-apis" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Create a lightweight client with only the APIs you need:</p>
+<pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">CustomEsiClient</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// Lightweight client with only specific APIs</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">customClient</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">CustomEsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;my-trading-bot&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">clients:</span><span class="hl-1"> [</span><span class="hl-2">&#39;characters&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;market&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;universe&#39;</span><span class="hl-1">] </span><span class="hl-5">// Only load what you need</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">// Access your selected APIs</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">character</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">customClient</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">?.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-8">123456</span><span class="hl-1">);</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">prices</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">customClient</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">?.</span><span class="hl-0">getMarketPrices</span><span class="hl-1">();</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:3-builder-pattern-for-custom-clients" class="tsd-anchor"></a><h3 class="tsd-anchor-link">3. Builder Pattern for Custom Clients<a href="#md:3-builder-pattern-for-custom-clients" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Use the builder pattern for more readable client construction:</p>
+<pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiClientBuilder</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// Build a custom client step by step</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClientBuilder</span><span class="hl-1">()</span><br/><span class="hl-1">  .</span><span class="hl-0">addClient</span><span class="hl-1">(</span><span class="hl-2">&#39;characters&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">addClient</span><span class="hl-1">(</span><span class="hl-2">&#39;corporations&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">addClients</span><span class="hl-1">([</span><span class="hl-2">&#39;market&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;universe&#39;</span><span class="hl-1">])</span><br/><span class="hl-1">  .</span><span class="hl-0">withClientId</span><span class="hl-1">(</span><span class="hl-2">&#39;my-corp-manager&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">withAccessToken</span><span class="hl-1">(</span><span class="hl-2">&#39;your-token&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">build</span><span class="hl-1">();</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:4-individual-api-clients-ultra-lightweight" class="tsd-anchor"></a><h3 class="tsd-anchor-link">4. Individual API Clients (Ultra Lightweight)<a href="#md:4-individual-api-clients-ultra-lightweight" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>Create standalone clients for single API groups:</p>
+<pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiApiFactory</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// Just the Character API</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">characterClient</span><span class="hl-1"> = </span><span class="hl-4">EsiApiFactory</span><span class="hl-1">.</span><span class="hl-0">createCharacterClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;character-lookup-tool&#39;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">character</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">characterClient</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-8">123456</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Just the Market API</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">marketClient</span><span class="hl-1"> = </span><span class="hl-4">EsiApiFactory</span><span class="hl-1">.</span><span class="hl-0">createMarketClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;market-analyzer&#39;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">prices</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">marketClient</span><span class="hl-1">.</span><span class="hl-0">getMarketPrices</span><span class="hl-1">();</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:5-direct-api-class-instantiation" class="tsd-anchor"></a><h3 class="tsd-anchor-link">5. Direct API Class Instantiation<a href="#md:5-direct-api-class-instantiation" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>For maximum control, instantiate API clients directly:</p>
+<pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">CharacterClient</span><span class="hl-1">, </span><span class="hl-4">ApiClient</span><span class="hl-1">, </span><span class="hl-4">ApiClientBuilder</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// Create the underlying API client</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">apiClient</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">ApiClientBuilder</span><span class="hl-1">()</span><br/><span class="hl-1">  .</span><span class="hl-0">withClientId</span><span class="hl-1">(</span><span class="hl-2">&#39;direct-api-client&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">withBaseUrl</span><span class="hl-1">(</span><span class="hl-2">&#39;https://esi.evetech.net&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">build</span><span class="hl-1">();</span><br/><br/><span class="hl-5">// Create the Character client directly</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">characterClient</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">CharacterClient</span><span class="hl-1">(</span><span class="hl-4">apiClient</span><span class="hl-1">);</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">character</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">characterClient</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-8">123456</span><span class="hl-1">);</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:📊-client-architecture" class="tsd-anchor"></a><h2 class="tsd-anchor-link">📊 Client Architecture<a href="#md:📊-client-architecture" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:available-client-types" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Available Client Types<a href="#md:available-client-types" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>All approaches above give you access to these organized API clients:</p>
+<pre><code class="typescript"><span class="hl-5">// Available clients:</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">alliance</span><span class="hl-1">      </span><span class="hl-5">// Alliance information</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">    </span><span class="hl-5">// Character data</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">corporations</span><span class="hl-1">  </span><span class="hl-5">// Corporation management</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">        </span><span class="hl-5">// Market data and trading</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">universe</span><span class="hl-1">      </span><span class="hl-5">// Universe information (systems, stations, items)</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">fleets</span><span class="hl-1">        </span><span class="hl-5">// Fleet management</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">industry</span><span class="hl-1">      </span><span class="hl-5">// Manufacturing and industry</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">mail</span><span class="hl-1">          </span><span class="hl-5">// In-game mail</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">contacts</span><span class="hl-1">      </span><span class="hl-5">// Contact management</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">assets</span><span class="hl-1">        </span><span class="hl-5">// Asset management</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">wallet</span><span class="hl-1">        </span><span class="hl-5">// Wallet operations</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">killmails</span><span class="hl-1">     </span><span class="hl-5">// Killmail data</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">location</span><span class="hl-1">      </span><span class="hl-5">// Character location</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">skills</span><span class="hl-1">        </span><span class="hl-5">// Character skills (if available)</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">factions</span><span class="hl-1">      </span><span class="hl-5">// Faction warfare</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">wars</span><span class="hl-1">          </span><span class="hl-5">// War information</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">sovereignty</span><span class="hl-1">   </span><span class="hl-5">// Sovereignty data</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">incursions</span><span class="hl-1">    </span><span class="hl-5">// Incursion information</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">opportunities</span><span class="hl-1"> </span><span class="hl-5">// Opportunities system</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">fittings</span><span class="hl-1">      </span><span class="hl-5">// Ship fittings</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">clones</span><span class="hl-1">        </span><span class="hl-5">// Clone management</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">loyalty</span><span class="hl-1">       </span><span class="hl-5">// Loyalty points</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">bookmarks</span><span class="hl-1">     </span><span class="hl-5">// Bookmark management</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">calendar</span><span class="hl-1">      </span><span class="hl-5">// Calendar events</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">contracts</span><span class="hl-1">     </span><span class="hl-5">// Contract system</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">insurance</span><span class="hl-1">     </span><span class="hl-5">// Insurance information</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">route</span><span class="hl-1">         </span><span class="hl-5">// Route planning</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">search</span><span class="hl-1">        </span><span class="hl-5">// Search functionality</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">status</span><span class="hl-1">        </span><span class="hl-5">// Server status</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">ui</span><span class="hl-1">            </span><span class="hl-5">// UI interactions</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:🎯-choosing-the-right-approach" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🎯 Choosing the Right Approach<a href="#md:🎯-choosing-the-right-approach" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:when-to-use-each-method" class="tsd-anchor"></a><h3 class="tsd-anchor-link">When to Use Each Method<a href="#md:when-to-use-each-method" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><table>
+<thead>
+<tr>
+<th>Approach</th>
+<th>Best For</th>
+<th>Memory Usage</th>
+<th>Startup Time</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><strong>Full EsiClient</strong></td>
+<td>Complete applications, multiple API usage</td>
+<td>High</td>
+<td>Slower</td>
+</tr>
+<tr>
+<td><strong>CustomEsiClient</strong></td>
+<td>Focused applications, selected APIs</td>
+<td>Medium</td>
+<td>Medium</td>
+</tr>
+<tr>
+<td><strong>EsiApiFactory</strong></td>
+<td>Single-purpose tools, microservices</td>
+<td>Low</td>
+<td>Fast</td>
+</tr>
+<tr>
+<td><strong>Direct Instantiation</strong></td>
+<td>Libraries, embedded usage</td>
+<td>Minimal</td>
+<td>Fastest</td>
+</tr>
+</tbody>
+</table>
+<a id="md:practical-examples-by-use-case" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Practical Examples by Use Case<a href="#md:practical-examples-by-use-case" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><a id="md:character-lookup-tool-ultra-lightweight" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Character Lookup Tool (Ultra Lightweight)<a href="#md:character-lookup-tool-ultra-lightweight" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiApiFactory</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">characterClient</span><span class="hl-1"> = </span><span class="hl-4">EsiApiFactory</span><span class="hl-1">.</span><span class="hl-0">createCharacterClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;character-lookup-v1&#39;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">// Just character operations</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">character</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">characterClient</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-8">123456</span><span class="hl-1">);</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">portrait</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">characterClient</span><span class="hl-1">.</span><span class="hl-0">getCharacterPortrait</span><span class="hl-1">(</span><span class="hl-8">123456</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`</span><span class="hl-6">${</span><span class="hl-4">character</span><span class="hl-9">.</span><span class="hl-4">body</span><span class="hl-9">.</span><span class="hl-4">name</span><span class="hl-6">}</span><span class="hl-2"> - </span><span class="hl-6">${</span><span class="hl-4">portrait</span><span class="hl-9">.</span><span class="hl-4">body</span><span class="hl-9">.</span><span class="hl-4">px128x128</span><span class="hl-6">}</span><span class="hl-2">`</span><span class="hl-1">);</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:trading-bot-selected-apis" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Trading Bot (Selected APIs)<a href="#md:trading-bot-selected-apis" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiClientBuilder</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">tradingBot</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClientBuilder</span><span class="hl-1">()</span><br/><span class="hl-1">  .</span><span class="hl-0">addClients</span><span class="hl-1">([</span><span class="hl-2">&#39;market&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;characters&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;universe&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;wallet&#39;</span><span class="hl-1">])</span><br/><span class="hl-1">  .</span><span class="hl-0">withClientId</span><span class="hl-1">(</span><span class="hl-2">&#39;trading-bot-v2&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">withAccessToken</span><span class="hl-1">(</span><span class="hl-4">process</span><span class="hl-1">.</span><span class="hl-4">env</span><span class="hl-1">.</span><span class="hl-7">EVE_ACCESS_TOKEN</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">build</span><span class="hl-1">();</span><br/><br/><span class="hl-5">// Only the APIs you need are loaded</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">prices</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">tradingBot</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">?.</span><span class="hl-0">getMarketPrices</span><span class="hl-1">();</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">wallet</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">tradingBot</span><span class="hl-1">.</span><span class="hl-4">wallet</span><span class="hl-1">?.</span><span class="hl-0">getCharacterWallet</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">);</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:corporation-management-dashboard-custom-client" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Corporation Management Dashboard (Custom Client)<a href="#md:corporation-management-dashboard-custom-client" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">CustomEsiClient</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">corpManager</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">CustomEsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;corp-dashboard&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">accessToken:</span><span class="hl-1"> </span><span class="hl-4">directorToken</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">clients:</span><span class="hl-1"> [</span><span class="hl-2">&#39;corporations&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;characters&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;assets&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;wallet&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;mail&#39;</span><span class="hl-1">]</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">// Efficient corp management with only needed APIs</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">corp</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">corpManager</span><span class="hl-1">.</span><span class="hl-4">corporations</span><span class="hl-1">?.</span><span class="hl-0">getCorporationInfo</span><span class="hl-1">(</span><span class="hl-4">corpId</span><span class="hl-1">);</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">members</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">corpManager</span><span class="hl-1">.</span><span class="hl-4">corporations</span><span class="hl-1">?.</span><span class="hl-0">getCorporationMembers</span><span class="hl-1">(</span><span class="hl-4">corpId</span><span class="hl-1">);</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:📋-common-usage-patterns" class="tsd-anchor"></a><h2 class="tsd-anchor-link">📋 Common Usage Patterns<a href="#md:📋-common-usage-patterns" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:public-data-no-authentication-required" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Public Data (No Authentication Required)<a href="#md:public-data-no-authentication-required" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-5">// Get alliance information</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">alliance</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">alliance</span><span class="hl-1">.</span><span class="hl-0">getAllianceById</span><span class="hl-1">(</span><span class="hl-8">99005338</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Alliance: </span><span class="hl-6">${</span><span class="hl-4">alliance</span><span class="hl-9">.</span><span class="hl-4">name</span><span class="hl-6">}</span><span class="hl-2"> [</span><span class="hl-6">${</span><span class="hl-4">alliance</span><span class="hl-9">.</span><span class="hl-4">ticker</span><span class="hl-6">}</span><span class="hl-2">]`</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Get character public information</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">character</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-8">1689391488</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Character: </span><span class="hl-6">${</span><span class="hl-4">character</span><span class="hl-9">.</span><span class="hl-4">name</span><span class="hl-6">}</span><span class="hl-2">`</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Get corporation information</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">corporation</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">corporations</span><span class="hl-1">.</span><span class="hl-0">getCorporationInfo</span><span class="hl-1">(</span><span class="hl-8">98742334</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Corporation: </span><span class="hl-6">${</span><span class="hl-4">corporation</span><span class="hl-9">.</span><span class="hl-4">name</span><span class="hl-6">}</span><span class="hl-2"> [</span><span class="hl-6">${</span><span class="hl-4">corporation</span><span class="hl-9">.</span><span class="hl-4">ticker</span><span class="hl-6">}</span><span class="hl-2">]`</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Get market prices</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">prices</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">.</span><span class="hl-0">getMarketPrices</span><span class="hl-1">();</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Found </span><span class="hl-6">${</span><span class="hl-4">prices</span><span class="hl-9">.</span><span class="hl-4">length</span><span class="hl-6">}</span><span class="hl-2"> market prices`</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Get solar system information</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">system</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">universe</span><span class="hl-1">.</span><span class="hl-0">getSystemById</span><span class="hl-1">(</span><span class="hl-8">30000142</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`System: </span><span class="hl-6">${</span><span class="hl-4">system</span><span class="hl-9">.</span><span class="hl-4">name</span><span class="hl-6">}</span><span class="hl-2"> (Security: </span><span class="hl-6">${</span><span class="hl-4">system</span><span class="hl-9">.</span><span class="hl-4">security_status</span><span class="hl-6">}</span><span class="hl-2">)`</span><span class="hl-1">);</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:authenticated-data-access-token-required" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Authenticated Data (Access Token Required)<a href="#md:authenticated-data-access-token-required" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-5">// Initialize with access token</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">authenticatedClient</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;your-app-name&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">accessToken:</span><span class="hl-1"> </span><span class="hl-2">&#39;your-character-access-token&#39;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">characterId</span><span class="hl-1"> = </span><span class="hl-8">1689391488</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// Get character&#39;s assets</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">assets</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">authenticatedClient</span><span class="hl-1">.</span><span class="hl-4">assets</span><span class="hl-1">.</span><span class="hl-0">getCharacterAssets</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Character has </span><span class="hl-6">${</span><span class="hl-4">assets</span><span class="hl-9">.</span><span class="hl-4">length</span><span class="hl-6">}</span><span class="hl-2"> assets`</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Get character&#39;s wallet balance</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">wallet</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">authenticatedClient</span><span class="hl-1">.</span><span class="hl-4">wallet</span><span class="hl-1">.</span><span class="hl-0">getCharacterWallet</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Wallet balance: </span><span class="hl-6">${</span><span class="hl-4">wallet</span><span class="hl-9">.</span><span class="hl-0">toLocaleString</span><span class="hl-9">()</span><span class="hl-6">}</span><span class="hl-2"> ISK`</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Get character&#39;s mail</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">mail</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">authenticatedClient</span><span class="hl-1">.</span><span class="hl-4">mail</span><span class="hl-1">.</span><span class="hl-0">getCharacterMail</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Character has </span><span class="hl-6">${</span><span class="hl-4">mail</span><span class="hl-9">.</span><span class="hl-4">length</span><span class="hl-6">}</span><span class="hl-2"> mail messages`</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Get character&#39;s market orders</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">orders</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">authenticatedClient</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">.</span><span class="hl-0">getCharacterOrders</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Character has </span><span class="hl-6">${</span><span class="hl-4">orders</span><span class="hl-9">.</span><span class="hl-4">length</span><span class="hl-6">}</span><span class="hl-2"> active market orders`</span><span class="hl-1">);</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:complex-workflows" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Complex Workflows<a href="#md:complex-workflows" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-5">// Character Profile Assembly</span><br/><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">getCompleteCharacterProfile</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> [</span><span class="hl-7">character</span><span class="hl-1">, </span><span class="hl-7">portrait</span><span class="hl-1">, </span><span class="hl-7">corporation</span><span class="hl-1">, </span><span class="hl-7">location</span><span class="hl-1">] = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-10">Promise</span><span class="hl-1">.</span><span class="hl-0">all</span><span class="hl-1">([</span><br/><span class="hl-1">    </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">),</span><br/><span class="hl-1">    </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">.</span><span class="hl-0">getCharacterPortrait</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">),</span><br/><span class="hl-1">    </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">).</span><span class="hl-0">then</span><span class="hl-1">(</span><span class="hl-4">char</span><span class="hl-1"> </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><br/><span class="hl-1">      </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">corporations</span><span class="hl-1">.</span><span class="hl-0">getCorporationInfo</span><span class="hl-1">(</span><span class="hl-4">char</span><span class="hl-1">.</span><span class="hl-4">corporation_id</span><span class="hl-1">)</span><br/><span class="hl-1">    ),</span><br/><span class="hl-1">    </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">location</span><span class="hl-1">.</span><span class="hl-0">getCharacterLocation</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">)</span><br/><span class="hl-1">  ]);</span><br/><br/><span class="hl-1">  </span><span class="hl-3">return</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">character</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-4">portrait</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-4">corporation</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-4">location</span><br/><span class="hl-1">  };</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-5">// Market Analysis</span><br/><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">analyzeMarketData</span><span class="hl-1">(</span><span class="hl-4">regionId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">, </span><span class="hl-4">typeId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> [</span><span class="hl-7">prices</span><span class="hl-1">, </span><span class="hl-7">orders</span><span class="hl-1">, </span><span class="hl-7">history</span><span class="hl-1">] = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-10">Promise</span><span class="hl-1">.</span><span class="hl-0">all</span><span class="hl-1">([</span><br/><span class="hl-1">    </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">.</span><span class="hl-0">getMarketPrices</span><span class="hl-1">(),</span><br/><span class="hl-1">    </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">.</span><span class="hl-0">getMarketOrders</span><span class="hl-1">(</span><span class="hl-4">regionId</span><span class="hl-1">, { </span><span class="hl-4">type_id:</span><span class="hl-1"> </span><span class="hl-4">typeId</span><span class="hl-1"> }),</span><br/><span class="hl-1">    </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">.</span><span class="hl-0">getMarketHistory</span><span class="hl-1">(</span><span class="hl-4">regionId</span><span class="hl-1">, </span><span class="hl-4">typeId</span><span class="hl-1">)</span><br/><span class="hl-1">  ]);</span><br/><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">currentPrice</span><span class="hl-1"> = </span><span class="hl-4">prices</span><span class="hl-1">.</span><span class="hl-0">find</span><span class="hl-1">(</span><span class="hl-4">p</span><span class="hl-1"> </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">p</span><span class="hl-1">.</span><span class="hl-4">type_id</span><span class="hl-1"> === </span><span class="hl-4">typeId</span><span class="hl-1">)?.</span><span class="hl-4">average_price</span><span class="hl-1">;</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">buyOrders</span><span class="hl-1"> = </span><span class="hl-4">orders</span><span class="hl-1">.</span><span class="hl-0">filter</span><span class="hl-1">(</span><span class="hl-4">o</span><span class="hl-1"> </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">is_buy_order</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">sellOrders</span><span class="hl-1"> = </span><span class="hl-4">orders</span><span class="hl-1">.</span><span class="hl-0">filter</span><span class="hl-1">(</span><span class="hl-4">o</span><span class="hl-1"> </span><span class="hl-6">=&gt;</span><span class="hl-1"> !</span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">is_buy_order</span><span class="hl-1">);</span><br/><br/><span class="hl-1">  </span><span class="hl-3">return</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">currentPrice</span><span class="hl-1">,</span><br/><span class="hl-1">    </span><span class="hl-4">bestBuyPrice:</span><span class="hl-1"> </span><span class="hl-4">Math</span><span class="hl-1">.</span><span class="hl-0">max</span><span class="hl-1">(...</span><span class="hl-4">buyOrders</span><span class="hl-1">.</span><span class="hl-0">map</span><span class="hl-1">(</span><span class="hl-4">o</span><span class="hl-1"> </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">price</span><span class="hl-1">)),</span><br/><span class="hl-1">    </span><span class="hl-4">bestSellPrice:</span><span class="hl-1"> </span><span class="hl-4">Math</span><span class="hl-1">.</span><span class="hl-0">min</span><span class="hl-1">(...</span><span class="hl-4">sellOrders</span><span class="hl-1">.</span><span class="hl-0">map</span><span class="hl-1">(</span><span class="hl-4">o</span><span class="hl-1"> </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">price</span><span class="hl-1">)),</span><br/><span class="hl-1">    </span><span class="hl-4">dailyVolume:</span><span class="hl-1"> </span><span class="hl-4">history</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">]?.</span><span class="hl-4">volume</span><span class="hl-1"> || </span><span class="hl-8">0</span><br/><span class="hl-1">  };</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:📊-error-handling" class="tsd-anchor"></a><h2 class="tsd-anchor-link">📊 Error Handling<a href="#md:📊-error-handling" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>The library provides comprehensive error handling with specific error types:</p>
+<pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">ApiError</span><span class="hl-1">, </span><span class="hl-4">ApiErrorType</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-3">try</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">alliance</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">alliance</span><span class="hl-1">.</span><span class="hl-0">getAllianceById</span><span class="hl-1">(</span><span class="hl-8">99999999</span><span class="hl-1">); </span><span class="hl-5">// Invalid ID</span><br/><span class="hl-1">} </span><span class="hl-3">catch</span><span class="hl-1"> (</span><span class="hl-4">error</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">error</span><span class="hl-1"> </span><span class="hl-6">instanceof</span><span class="hl-1"> </span><span class="hl-10">ApiError</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-3">switch</span><span class="hl-1"> (</span><span class="hl-4">error</span><span class="hl-1">.</span><span class="hl-4">type</span><span class="hl-1">) {</span><br/><span class="hl-1">      </span><span class="hl-3">case</span><span class="hl-1"> </span><span class="hl-4">ApiErrorType</span><span class="hl-1">.</span><span class="hl-7">NOT_FOUND</span><span class="hl-1">:</span><br/><span class="hl-1">        </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">&#39;Alliance not found&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">        </span><span class="hl-3">break</span><span class="hl-1">;</span><br/><span class="hl-1">      </span><span class="hl-3">case</span><span class="hl-1"> </span><span class="hl-4">ApiErrorType</span><span class="hl-1">.</span><span class="hl-7">RATE_LIMITED</span><span class="hl-1">:</span><br/><span class="hl-1">        </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">&#39;Rate limited - retry after:&#39;</span><span class="hl-1">, </span><span class="hl-4">error</span><span class="hl-1">.</span><span class="hl-4">retryAfter</span><span class="hl-1">);</span><br/><span class="hl-1">        </span><span class="hl-3">break</span><span class="hl-1">;</span><br/><span class="hl-1">      </span><span class="hl-3">case</span><span class="hl-1"> </span><span class="hl-4">ApiErrorType</span><span class="hl-1">.</span><span class="hl-7">SERVER_ERROR</span><span class="hl-1">:</span><br/><span class="hl-1">        </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">&#39;ESI server error:&#39;</span><span class="hl-1">, </span><span class="hl-4">error</span><span class="hl-1">.</span><span class="hl-4">statusCode</span><span class="hl-1">);</span><br/><span class="hl-1">        </span><span class="hl-3">break</span><span class="hl-1">;</span><br/><span class="hl-1">      </span><span class="hl-3">case</span><span class="hl-1"> </span><span class="hl-4">ApiErrorType</span><span class="hl-1">.</span><span class="hl-7">NETWORK_ERROR</span><span class="hl-1">:</span><br/><span class="hl-1">        </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">&#39;Network connectivity issue&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">        </span><span class="hl-3">break</span><span class="hl-1">;</span><br/><span class="hl-1">      </span><span class="hl-3">case</span><span class="hl-1"> </span><span class="hl-4">ApiErrorType</span><span class="hl-1">.</span><span class="hl-7">AUTHENTICATION_ERROR</span><span class="hl-1">:</span><br/><span class="hl-1">        </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">&#39;Invalid or expired access token&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">        </span><span class="hl-3">break</span><span class="hl-1">;</span><br/><span class="hl-1">      </span><span class="hl-3">default</span><span class="hl-1">:</span><br/><span class="hl-1">        </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">&#39;Unexpected error:&#39;</span><span class="hl-1">, </span><span class="hl-4">error</span><span class="hl-1">.</span><span class="hl-4">message</span><span class="hl-1">);</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:graceful-error-handling-in-complex-workflows" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Graceful Error Handling in Complex Workflows<a href="#md:graceful-error-handling-in-complex-workflows" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">safeCharacterLookup</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-3">try</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">// Use Promise.allSettled for partial success scenarios</span><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">results</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-10">Promise</span><span class="hl-1">.</span><span class="hl-0">allSettled</span><span class="hl-1">([</span><br/><span class="hl-1">      </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">),</span><br/><span class="hl-1">      </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">.</span><span class="hl-0">getCharacterPortrait</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">),</span><br/><span class="hl-1">      </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">location</span><span class="hl-1">.</span><span class="hl-0">getCharacterLocation</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">)</span><br/><span class="hl-1">    ]);</span><br/><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">profile</span><span class="hl-1">: </span><span class="hl-10">any</span><span class="hl-1"> = {};</span><br/><br/><span class="hl-1">    </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">results</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">].</span><span class="hl-4">status</span><span class="hl-1"> === </span><span class="hl-2">&#39;fulfilled&#39;</span><span class="hl-1">) {</span><br/><span class="hl-1">      </span><span class="hl-4">profile</span><span class="hl-1">.</span><span class="hl-4">character</span><span class="hl-1"> = </span><span class="hl-4">results</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">].</span><span class="hl-4">value</span><span class="hl-1">;</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">    </span><br/><span class="hl-1">    </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">results</span><span class="hl-1">[</span><span class="hl-8">1</span><span class="hl-1">].</span><span class="hl-4">status</span><span class="hl-1"> === </span><span class="hl-2">&#39;fulfilled&#39;</span><span class="hl-1">) {</span><br/><span class="hl-1">      </span><span class="hl-4">profile</span><span class="hl-1">.</span><span class="hl-4">portrait</span><span class="hl-1"> = </span><span class="hl-4">results</span><span class="hl-1">[</span><span class="hl-8">1</span><span class="hl-1">].</span><span class="hl-4">value</span><span class="hl-1">;</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">    </span><br/><span class="hl-1">    </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">results</span><span class="hl-1">[</span><span class="hl-8">2</span><span class="hl-1">].</span><span class="hl-4">status</span><span class="hl-1"> === </span><span class="hl-2">&#39;fulfilled&#39;</span><span class="hl-1">) {</span><br/><span class="hl-1">      </span><span class="hl-4">profile</span><span class="hl-1">.</span><span class="hl-4">location</span><span class="hl-1"> = </span><span class="hl-4">results</span><span class="hl-1">[</span><span class="hl-8">2</span><span class="hl-1">].</span><span class="hl-4">value</span><span class="hl-1">;</span><br/><span class="hl-1">    } </span><span class="hl-3">else</span><span class="hl-1"> </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">results</span><span class="hl-1">[</span><span class="hl-8">2</span><span class="hl-1">].</span><span class="hl-4">status</span><span class="hl-1"> === </span><span class="hl-2">&#39;rejected&#39;</span><span class="hl-1">) {</span><br/><span class="hl-1">      </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">&#39;Location unavailable (character may be offline)&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">    }</span><br/><br/><span class="hl-1">    </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-4">profile</span><span class="hl-1">;</span><br/><span class="hl-1">  } </span><span class="hl-3">catch</span><span class="hl-1"> (</span><span class="hl-4">error</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">error</span><span class="hl-1">(</span><span class="hl-2">&#39;Failed to get character data:&#39;</span><span class="hl-1">, </span><span class="hl-4">error</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-6">null</span><span class="hl-1">;</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:⚡-performance--caching" class="tsd-anchor"></a><h2 class="tsd-anchor-link">⚡ Performance &amp; Caching<a href="#md:⚡-performance--caching" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:intelligent-etag-caching" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Intelligent ETag Caching<a href="#md:intelligent-etag-caching" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>ESI.ts includes a sophisticated ETag caching system that automatically optimizes API calls by avoiding unnecessary data transfers. This feature is <strong>enabled by default</strong> and works transparently with all GET requests.</p>
+<a id="md:how-etag-caching-works" class="tsd-anchor"></a><h4 class="tsd-anchor-link">How ETag Caching Works<a href="#md:how-etag-caching-works" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><p>ETags (Entity Tags) are unique identifiers returned by ESI servers that represent the current version of a resource. When data hasn't changed, the server returns a <code>304 Not Modified</code> status instead of the full data, dramatically reducing bandwidth usage and improving response times.</p>
+<a id="md:basic-usage-automatic" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Basic Usage (Automatic)<a href="#md:basic-usage-automatic" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiClient</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// ETag caching is enabled by default</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;my-eve-app&#39;</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">// First call - downloads and caches data</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">alliances1</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">alliance</span><span class="hl-1">.</span><span class="hl-0">getAlliances</span><span class="hl-1">();</span><br/><br/><span class="hl-5">// Second call - returns cached data if unchanged (304 response)</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">alliances2</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">alliance</span><span class="hl-1">.</span><span class="hl-0">getAlliances</span><span class="hl-1">(); </span><span class="hl-5">// ⚡ Lightning fast!</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:custom-cache-configuration" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Custom Cache Configuration<a href="#md:custom-cache-configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="typescript"><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;my-eve-app&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">enableETagCache:</span><span class="hl-1"> </span><span class="hl-6">true</span><span class="hl-1">, </span><span class="hl-5">// Default: true</span><br/><span class="hl-1">  </span><span class="hl-4">etagCacheConfig:</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">maxEntries:</span><span class="hl-1"> </span><span class="hl-8">1000</span><span class="hl-1">,      </span><span class="hl-5">// Max cached responses (default: 1000)</span><br/><span class="hl-1">    </span><span class="hl-4">defaultTtl:</span><span class="hl-1"> </span><span class="hl-8">300000</span><span class="hl-1">,    </span><span class="hl-5">// Cache TTL in ms (default: 5 minutes)</span><br/><span class="hl-1">    </span><span class="hl-4">cleanupInterval:</span><span class="hl-1"> </span><span class="hl-8">60000</span><span class="hl-1">, </span><span class="hl-5">// Cleanup frequency (default: 1 minute)</span><br/><span class="hl-1">    </span><span class="hl-4">persistToStorage:</span><span class="hl-1"> </span><span class="hl-6">true</span><span class="hl-1">, </span><span class="hl-5">// Save to localStorage (default: false)</span><br/><span class="hl-1">    </span><span class="hl-4">storageKey:</span><span class="hl-1"> </span><span class="hl-2">&#39;my-esi-cache&#39;</span><span class="hl-1"> </span><span class="hl-5">// Custom storage key</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">});</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:cache-management" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Cache Management<a href="#md:cache-management" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="typescript"><span class="hl-5">// Get cache statistics</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">stats</span><span class="hl-1"> = </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">getCacheStats</span><span class="hl-1">();</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Cache: </span><span class="hl-6">${</span><span class="hl-4">stats</span><span class="hl-9">.</span><span class="hl-4">totalEntries</span><span class="hl-6">}</span><span class="hl-2">/</span><span class="hl-6">${</span><span class="hl-4">stats</span><span class="hl-9">.</span><span class="hl-4">maxEntries</span><span class="hl-6">}</span><span class="hl-2"> entries`</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Hit rate optimization: </span><span class="hl-6">${</span><span class="hl-4">stats</span><span class="hl-9">.</span><span class="hl-4">hitRate</span><span class="hl-6">}</span><span class="hl-2">%`</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Clear cache manually</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">clearCache</span><span class="hl-1">();</span><br/><br/><span class="hl-5">// Update cache settings at runtime</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">updateCacheConfig</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">maxEntries:</span><span class="hl-1"> </span><span class="hl-8">2000</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">defaultTtl:</span><span class="hl-1"> </span><span class="hl-8">600000</span><span class="hl-1"> </span><span class="hl-5">// 10 minutes</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">// Disable caching for specific use cases</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">enableETagCache:</span><span class="hl-1"> </span><span class="hl-6">false</span><span class="hl-1"> </span><span class="hl-5">// Disable caching entirely</span><br/><span class="hl-1">});</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:performance-benefits" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Performance Benefits<a href="#md:performance-benefits" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><ul>
+<li><strong>🚀 Faster Response Times</strong>: Cached responses return instantly</li>
+<li><strong>📉 Reduced Bandwidth</strong>: Avoid downloading unchanged data</li>
+<li><strong>🔋 Server-Friendly</strong>: Reduces load on ESI servers</li>
+<li><strong>💰 Cost Effective</strong>: Lower data usage for mobile/metered connections</li>
+<li><strong>🎯 Smart Caching</strong>: Only caches GET requests with ETags</li>
+</ul>
+<a id="md:cache-behavior" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Cache Behavior<a href="#md:cache-behavior" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><table>
+<thead>
+<tr>
+<th>Scenario</th>
+<th>Behavior</th>
+<th>Performance Impact</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td>First API call</td>
+<td>Downloads data, stores ETag</td>
+<td>Normal speed</td>
+</tr>
+<tr>
+<td>Data unchanged</td>
+<td>Returns cached data (304)</td>
+<td>⚡ <strong>~95% faster</strong></td>
+</tr>
+<tr>
+<td>Data changed</td>
+<td>Downloads new data, updates cache</td>
+<td>Normal speed</td>
+</tr>
+<tr>
+<td>Cache expired</td>
+<td>Downloads fresh data</td>
+<td>Normal speed</td>
+</tr>
+<tr>
+<td>Cache full</td>
+<td>Evicts oldest entries automatically</td>
+<td>Minimal impact</td>
+</tr>
+</tbody>
+</table>
+<a id="md:advanced-etag-features" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Advanced ETag Features<a href="#md:advanced-etag-features" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><pre><code class="typescript"><span class="hl-5">// Monitor cache performance</span><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">on</span><span class="hl-1">(</span><span class="hl-2">&#39;cacheHit&#39;</span><span class="hl-1">, (</span><span class="hl-4">url</span><span class="hl-1">, </span><span class="hl-4">etag</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Cache hit for </span><span class="hl-6">${</span><span class="hl-4">url</span><span class="hl-6">}</span><span class="hl-2"> with ETag </span><span class="hl-6">${</span><span class="hl-4">etag</span><span class="hl-6">}</span><span class="hl-2">`</span><span class="hl-1">);</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">on</span><span class="hl-1">(</span><span class="hl-2">&#39;cacheMiss&#39;</span><span class="hl-1">, (</span><span class="hl-4">url</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Cache miss for </span><span class="hl-6">${</span><span class="hl-4">url</span><span class="hl-6">}</span><span class="hl-2"> - downloading fresh data`</span><span class="hl-1">);</span><br/><span class="hl-1">});</span><br/><br/><span class="hl-5">// Programmatic cache inspection</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">cache</span><span class="hl-1"> = </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">getETagCache</span><span class="hl-1">();</span><br/><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">cache</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">entry</span><span class="hl-1"> = </span><span class="hl-4">cache</span><span class="hl-1">.</span><span class="hl-0">get</span><span class="hl-1">(</span><span class="hl-2">&#39;https://esi.evetech.net/latest/alliances&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">entry</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`Cached data age: </span><span class="hl-6">${</span><span class="hl-4">Date</span><span class="hl-9">.</span><span class="hl-0">now</span><span class="hl-9">() </span><span class="hl-1">-</span><span class="hl-9"> </span><span class="hl-4">entry</span><span class="hl-9">.</span><span class="hl-4">timestamp</span><span class="hl-6">}</span><span class="hl-2">ms`</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-2">`ETag: </span><span class="hl-6">${</span><span class="hl-4">entry</span><span class="hl-9">.</span><span class="hl-4">etag</span><span class="hl-6">}</span><span class="hl-2">`</span><span class="hl-1">);</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:when-etag-caching-helps-most" class="tsd-anchor"></a><h4 class="tsd-anchor-link">When ETag Caching Helps Most<a href="#md:when-etag-caching-helps-most" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><ul>
+<li><strong>📊 Market Data</strong>: Price lists that update periodically</li>
+<li><strong>🏢 Corporation/Alliance Info</strong>: Relatively static organizational data</li>
+<li><strong>🌌 Universe Data</strong>: Star system, station, and type information</li>
+<li><strong>👥 Character Lists</strong>: Member rosters and public information</li>
+<li><strong>📈 Statistics</strong>: Aggregate data that updates on intervals</li>
+</ul>
+<a id="md:implementation-details" class="tsd-anchor"></a><h4 class="tsd-anchor-link">Implementation Details<a href="#md:implementation-details" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h4><ul>
+<li><strong>Architecture</strong>: Implemented at the core <code>ApiRequestHandler</code> level</li>
+<li><strong>Scope</strong>: Works with ALL GET requests automatically</li>
+<li><strong>Compatibility</strong>: Fully backward compatible - existing code works unchanged</li>
+<li><strong>Thread Safety</strong>: Uses atomic operations for cache management</li>
+<li><strong>Memory Efficient</strong>: Automatic cleanup and size management</li>
+<li><strong>Storage Options</strong>: In-memory (default) or persistent localStorage</li>
+</ul>
+<a id="md:🔧-advanced-configuration" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🔧 Advanced Configuration<a href="#md:🔧-advanced-configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:custom-timeout-and-retry-logic" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Custom Timeout and Retry Logic<a href="#md:custom-timeout-and-retry-logic" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;my-eve-app&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">timeout:</span><span class="hl-1"> </span><span class="hl-8">60000</span><span class="hl-1">,      </span><span class="hl-5">// 60 second timeout</span><br/><span class="hl-1">  </span><span class="hl-4">retryAttempts:</span><span class="hl-1"> </span><span class="hl-8">5</span><span class="hl-1">,    </span><span class="hl-5">// Retry up to 5 times</span><br/><span class="hl-1">  </span><span class="hl-4">baseUrl:</span><span class="hl-1"> </span><span class="hl-2">&#39;https://esi.evetech.net&#39;</span><span class="hl-1"> </span><span class="hl-5">// Custom ESI endpoint (optional)</span><br/><span class="hl-1">});</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:using-environment-variables" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Using Environment Variables<a href="#md:using-environment-variables" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-5">// Set environment variables</span><br/><span class="hl-5">// ESI_CLIENT_ID=your-app-name</span><br/><span class="hl-5">// ESI_ACCESS_TOKEN=your-token</span><br/><span class="hl-5">// ESI_TIMEOUT=30000</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">  </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-4">process</span><span class="hl-1">.</span><span class="hl-4">env</span><span class="hl-1">.</span><span class="hl-7">ESI_CLIENT_ID</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">accessToken:</span><span class="hl-1"> </span><span class="hl-4">process</span><span class="hl-1">.</span><span class="hl-4">env</span><span class="hl-1">.</span><span class="hl-7">ESI_ACCESS_TOKEN</span><span class="hl-1">,</span><br/><span class="hl-1">  </span><span class="hl-4">timeout:</span><span class="hl-1"> </span><span class="hl-0">parseInt</span><span class="hl-1">(</span><span class="hl-4">process</span><span class="hl-1">.</span><span class="hl-4">env</span><span class="hl-1">.</span><span class="hl-7">ESI_TIMEOUT</span><span class="hl-1"> || </span><span class="hl-2">&#39;30000&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">});</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:🚀-real-world-examples" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🚀 Real-World Examples<a href="#md:🚀-real-world-examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:eve-market-trading-bot-lightweight-version" class="tsd-anchor"></a><h3 class="tsd-anchor-link">EVE Market Trading Bot (Lightweight Version)<a href="#md:eve-market-trading-bot-lightweight-version" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiClientBuilder</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">class</span><span class="hl-1"> </span><span class="hl-10">MarketBot</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">private</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">: </span><span class="hl-10">any</span><span class="hl-1">; </span><span class="hl-5">// CustomEsiClient</span><br/><br/><span class="hl-1">  </span><span class="hl-6">constructor</span><span class="hl-1">(</span><span class="hl-4">accessToken</span><span class="hl-1">: </span><span class="hl-10">string</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-5">// Only load the APIs we actually need</span><br/><span class="hl-1">    </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClientBuilder</span><span class="hl-1">()</span><br/><span class="hl-1">      .</span><span class="hl-0">addClients</span><span class="hl-1">([</span><span class="hl-2">&#39;market&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;universe&#39;</span><span class="hl-1">])</span><br/><span class="hl-1">      .</span><span class="hl-0">withClientId</span><span class="hl-1">(</span><span class="hl-2">&#39;market-bot-v1&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">      .</span><span class="hl-0">withAccessToken</span><span class="hl-1">(</span><span class="hl-4">accessToken</span><span class="hl-1">)</span><br/><span class="hl-1">      .</span><span class="hl-0">build</span><span class="hl-1">();</span><br/><span class="hl-1">  }</span><br/><br/><span class="hl-1">  </span><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-0">findArbitrageOpportunities</span><span class="hl-1">(</span><span class="hl-4">regionId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">, </span><span class="hl-4">typeId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-3">try</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-6">const</span><span class="hl-1"> [</span><span class="hl-7">orders</span><span class="hl-1">, </span><span class="hl-7">history</span><span class="hl-1">] = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-10">Promise</span><span class="hl-1">.</span><span class="hl-0">all</span><span class="hl-1">([</span><br/><span class="hl-1">        </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">.</span><span class="hl-0">getMarketOrders</span><span class="hl-1">(</span><span class="hl-4">regionId</span><span class="hl-1">, { </span><span class="hl-4">type_id:</span><span class="hl-1"> </span><span class="hl-4">typeId</span><span class="hl-1"> }),</span><br/><span class="hl-1">        </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">market</span><span class="hl-1">.</span><span class="hl-0">getMarketHistory</span><span class="hl-1">(</span><span class="hl-4">regionId</span><span class="hl-1">, </span><span class="hl-4">typeId</span><span class="hl-1">)</span><br/><span class="hl-1">      ]);</span><br/><br/><span class="hl-1">      </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">buyOrders</span><span class="hl-1"> = </span><span class="hl-4">orders</span><span class="hl-1">.</span><span class="hl-0">filter</span><span class="hl-1">(</span><span class="hl-4">o</span><span class="hl-1"> </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">is_buy_order</span><span class="hl-1">).</span><span class="hl-0">sort</span><span class="hl-1">((</span><span class="hl-4">a</span><span class="hl-1">, </span><span class="hl-4">b</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">b</span><span class="hl-1">.</span><span class="hl-4">price</span><span class="hl-1"> - </span><span class="hl-4">a</span><span class="hl-1">.</span><span class="hl-4">price</span><span class="hl-1">);</span><br/><span class="hl-1">      </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">sellOrders</span><span class="hl-1"> = </span><span class="hl-4">orders</span><span class="hl-1">.</span><span class="hl-0">filter</span><span class="hl-1">(</span><span class="hl-4">o</span><span class="hl-1"> </span><span class="hl-6">=&gt;</span><span class="hl-1"> !</span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">is_buy_order</span><span class="hl-1">).</span><span class="hl-0">sort</span><span class="hl-1">((</span><span class="hl-4">a</span><span class="hl-1">, </span><span class="hl-4">b</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">a</span><span class="hl-1">.</span><span class="hl-4">price</span><span class="hl-1"> - </span><span class="hl-4">b</span><span class="hl-1">.</span><span class="hl-4">price</span><span class="hl-1">);</span><br/><br/><span class="hl-1">      </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">buyOrders</span><span class="hl-1">.</span><span class="hl-4">length</span><span class="hl-1"> &gt; </span><span class="hl-8">0</span><span class="hl-1"> &amp;&amp; </span><span class="hl-4">sellOrders</span><span class="hl-1">.</span><span class="hl-4">length</span><span class="hl-1"> &gt; </span><span class="hl-8">0</span><span class="hl-1">) {</span><br/><span class="hl-1">        </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">spread</span><span class="hl-1"> = </span><span class="hl-4">buyOrders</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">].</span><span class="hl-4">price</span><span class="hl-1"> - </span><span class="hl-4">sellOrders</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">].</span><span class="hl-4">price</span><span class="hl-1">;</span><br/><span class="hl-1">        </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">spreadPercent</span><span class="hl-1"> = (</span><span class="hl-4">spread</span><span class="hl-1"> / </span><span class="hl-4">sellOrders</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">].</span><span class="hl-4">price</span><span class="hl-1">) * </span><span class="hl-8">100</span><span class="hl-1">;</span><br/><br/><span class="hl-1">        </span><span class="hl-3">return</span><span class="hl-1"> {</span><br/><span class="hl-1">          </span><span class="hl-4">profitable:</span><span class="hl-1"> </span><span class="hl-4">spread</span><span class="hl-1"> &gt; </span><span class="hl-8">0</span><span class="hl-1">,</span><br/><span class="hl-1">          </span><span class="hl-4">spread</span><span class="hl-1">,</span><br/><span class="hl-1">          </span><span class="hl-4">spreadPercent</span><span class="hl-1">,</span><br/><span class="hl-1">          </span><span class="hl-4">bestBuy:</span><span class="hl-1"> </span><span class="hl-4">buyOrders</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">],</span><br/><span class="hl-1">          </span><span class="hl-4">bestSell:</span><span class="hl-1"> </span><span class="hl-4">sellOrders</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">],</span><br/><span class="hl-1">          </span><span class="hl-4">dailyVolume:</span><span class="hl-1"> </span><span class="hl-4">history</span><span class="hl-1">[</span><span class="hl-8">0</span><span class="hl-1">]?.</span><span class="hl-4">volume</span><span class="hl-1"> || </span><span class="hl-8">0</span><br/><span class="hl-1">        };</span><br/><span class="hl-1">      }</span><br/><br/><span class="hl-1">      </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-6">null</span><span class="hl-1">;</span><br/><span class="hl-1">    } </span><span class="hl-3">catch</span><span class="hl-1"> (</span><span class="hl-4">error</span><span class="hl-1">) {</span><br/><span class="hl-1">      </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">error</span><span class="hl-1">(</span><span class="hl-2">&#39;Failed to analyze market:&#39;</span><span class="hl-1">, </span><span class="hl-4">error</span><span class="hl-1">);</span><br/><span class="hl-1">      </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-6">null</span><span class="hl-1">;</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:corporation-management-dashboard-custom-client-1" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Corporation Management Dashboard (Custom Client)<a href="#md:corporation-management-dashboard-custom-client-1" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">CustomEsiClient</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-6">class</span><span class="hl-1"> </span><span class="hl-10">CorporationManager</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">private</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">: </span><span class="hl-10">CustomEsiClient</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-6">constructor</span><span class="hl-1">(</span><span class="hl-4">accessToken</span><span class="hl-1">: </span><span class="hl-10">string</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-5">// Only load corporation-related APIs</span><br/><span class="hl-1">    </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">CustomEsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">      </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;corp-manager&#39;</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-4">accessToken</span><span class="hl-1">,</span><br/><span class="hl-1">      </span><span class="hl-4">clients:</span><span class="hl-1"> [</span><span class="hl-2">&#39;corporations&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;characters&#39;</span><span class="hl-1">, </span><span class="hl-2">&#39;wallet&#39;</span><span class="hl-1">]</span><br/><span class="hl-1">    });</span><br/><span class="hl-1">  }</span><br/><br/><span class="hl-1">  </span><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-0">getCorporationOverview</span><span class="hl-1">(</span><span class="hl-4">corporationId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-3">try</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-6">const</span><span class="hl-1"> [</span><span class="hl-7">corp</span><span class="hl-1">, </span><span class="hl-7">members</span><span class="hl-1">, </span><span class="hl-7">wallets</span><span class="hl-1">] = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-10">Promise</span><span class="hl-1">.</span><span class="hl-0">all</span><span class="hl-1">([</span><br/><span class="hl-1">        </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">corporations</span><span class="hl-1">.</span><span class="hl-0">getCorporationInfo</span><span class="hl-1">(</span><span class="hl-4">corporationId</span><span class="hl-1">),</span><br/><span class="hl-1">        </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">corporations</span><span class="hl-1">.</span><span class="hl-0">getCorporationMembers</span><span class="hl-1">(</span><span class="hl-4">corporationId</span><span class="hl-1">),</span><br/><span class="hl-1">        </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">wallet</span><span class="hl-1">.</span><span class="hl-0">getCorporationWallets</span><span class="hl-1">(</span><span class="hl-4">corporationId</span><span class="hl-1">)</span><br/><span class="hl-1">      ]);</span><br/><br/><span class="hl-1">      </span><span class="hl-3">return</span><span class="hl-1"> {</span><br/><span class="hl-1">        </span><span class="hl-4">corporation:</span><span class="hl-1"> </span><span class="hl-4">corp</span><span class="hl-1">,</span><br/><span class="hl-1">        </span><span class="hl-4">memberCount:</span><span class="hl-1"> </span><span class="hl-4">members</span><span class="hl-1">.</span><span class="hl-4">length</span><span class="hl-1">,</span><br/><span class="hl-1">        </span><span class="hl-4">totalBalance:</span><span class="hl-1"> </span><span class="hl-4">wallets</span><span class="hl-1">.</span><span class="hl-0">reduce</span><span class="hl-1">((</span><span class="hl-4">sum</span><span class="hl-1">, </span><span class="hl-4">wallet</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">sum</span><span class="hl-1"> + </span><span class="hl-4">wallet</span><span class="hl-1">.</span><span class="hl-4">balance</span><span class="hl-1">, </span><span class="hl-8">0</span><span class="hl-1">)</span><br/><span class="hl-1">      };</span><br/><span class="hl-1">    } </span><span class="hl-3">catch</span><span class="hl-1"> (</span><span class="hl-4">error</span><span class="hl-1">) {</span><br/><span class="hl-1">      </span><span class="hl-3">if</span><span class="hl-1"> (</span><span class="hl-4">error</span><span class="hl-1"> </span><span class="hl-6">instanceof</span><span class="hl-1"> </span><span class="hl-10">ApiError</span><span class="hl-1"> &amp;&amp; </span><span class="hl-4">error</span><span class="hl-1">.</span><span class="hl-4">type</span><span class="hl-1"> === </span><span class="hl-4">ApiErrorType</span><span class="hl-1">.</span><span class="hl-7">AUTHENTICATION_ERROR</span><span class="hl-1">) {</span><br/><span class="hl-1">        </span><span class="hl-3">throw</span><span class="hl-1"> </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">Error</span><span class="hl-1">(</span><span class="hl-2">&#39;Insufficient permissions to access corporation data&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">      }</span><br/><span class="hl-1">      </span><span class="hl-3">throw</span><span class="hl-1"> </span><span class="hl-4">error</span><span class="hl-1">;</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:simple-character-lookup-direct-api" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Simple Character Lookup (Direct API)<a href="#md:simple-character-lookup-direct-api" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiApiFactory</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// Ultra-lightweight: just one API, one function</span><br/><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">lookupCharacter</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">) {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">characterClient</span><span class="hl-1"> = </span><span class="hl-4">EsiApiFactory</span><span class="hl-1">.</span><span class="hl-0">createCharacterClient</span><span class="hl-1">({</span><br/><span class="hl-1">    </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;simple-lookup&#39;</span><br/><span class="hl-1">  });</span><br/><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">character</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">characterClient</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-4">characterId</span><span class="hl-1">);</span><br/><span class="hl-1">  </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-4">character</span><span class="hl-1">.</span><span class="hl-4">body</span><span class="hl-1">.</span><span class="hl-4">name</span><span class="hl-1">;</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-5">// Usage</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">name</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-0">lookupCharacter</span><span class="hl-1">(</span><span class="hl-8">1689391488</span><span class="hl-1">);</span><br/><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-4">name</span><span class="hl-1">); </span><span class="hl-5">// &quot;deiseman&quot;</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:direct-api-class-usage" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Direct API Class Usage<a href="#md:direct-api-class-usage" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">CharacterClient</span><span class="hl-1">, </span><span class="hl-4">ApiClientBuilder</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// Maximum control - build exactly what you need</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">apiClient</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">ApiClientBuilder</span><span class="hl-1">()</span><br/><span class="hl-1">  .</span><span class="hl-0">setClientId</span><span class="hl-1">(</span><span class="hl-2">&#39;direct-usage&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">setLink</span><span class="hl-1">(</span><span class="hl-2">&#39;https://esi.evetech.net&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">  .</span><span class="hl-0">build</span><span class="hl-1">();</span><br/><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">characterClient</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">CharacterClient</span><span class="hl-1">(</span><span class="hl-4">apiClient</span><span class="hl-1">);</span><br/><br/><span class="hl-5">// Direct usage without any wrapper</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">character</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">characterClient</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-8">123456</span><span class="hl-1">);</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">portrait</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">characterClient</span><span class="hl-1">.</span><span class="hl-0">getCharacterPortrait</span><span class="hl-1">(</span><span class="hl-8">123456</span><span class="hl-1">);</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:microservice-example-single-responsibility" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Microservice Example (Single Responsibility)<a href="#md:microservice-example-single-responsibility" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiApiFactory</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-5">// A microservice that only needs market data</span><br/><span class="hl-6">class</span><span class="hl-1"> </span><span class="hl-10">PriceService</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">private</span><span class="hl-1"> </span><span class="hl-4">marketClient</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-6">constructor</span><span class="hl-1">() {</span><br/><span class="hl-1">    </span><span class="hl-5">// Only load what this service needs</span><br/><span class="hl-1">    </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">marketClient</span><span class="hl-1"> = </span><span class="hl-4">EsiApiFactory</span><span class="hl-1">.</span><span class="hl-0">createMarketClient</span><span class="hl-1">({</span><br/><span class="hl-1">      </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;price-service-v1&#39;</span><br/><span class="hl-1">    });</span><br/><span class="hl-1">  }</span><br/><br/><span class="hl-1">  </span><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-0">getCurrentPrice</span><span class="hl-1">(</span><span class="hl-4">typeId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">): </span><span class="hl-10">Promise</span><span class="hl-1">&lt;</span><span class="hl-10">number</span><span class="hl-1">&gt; {</span><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">prices</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">marketClient</span><span class="hl-1">.</span><span class="hl-0">getMarketPrices</span><span class="hl-1">();</span><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">price</span><span class="hl-1"> = </span><span class="hl-4">prices</span><span class="hl-1">.</span><span class="hl-4">body</span><span class="hl-1">.</span><span class="hl-0">find</span><span class="hl-1">((</span><span class="hl-4">p</span><span class="hl-1">: </span><span class="hl-10">any</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">p</span><span class="hl-1">.</span><span class="hl-4">type_id</span><span class="hl-1"> === </span><span class="hl-4">typeId</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-4">price</span><span class="hl-1">?.</span><span class="hl-4">average_price</span><span class="hl-1"> || </span><span class="hl-8">0</span><span class="hl-1">;</span><br/><span class="hl-1">  }</span><br/><br/><span class="hl-1">  </span><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-0">getBestPrices</span><span class="hl-1">(</span><span class="hl-4">regionId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">, </span><span class="hl-4">typeId</span><span class="hl-1">: </span><span class="hl-10">number</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">orders</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">marketClient</span><span class="hl-1">.</span><span class="hl-0">getMarketOrders</span><span class="hl-1">(</span><span class="hl-4">regionId</span><span class="hl-1">, { </span><span class="hl-4">type_id:</span><span class="hl-1"> </span><span class="hl-4">typeId</span><span class="hl-1"> });</span><br/><span class="hl-1">    </span><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">buyOrders</span><span class="hl-1"> = </span><span class="hl-4">orders</span><span class="hl-1">.</span><span class="hl-4">body</span><span class="hl-1">.</span><span class="hl-0">filter</span><span class="hl-1">((</span><span class="hl-4">o</span><span class="hl-1">: </span><span class="hl-10">any</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">is_buy_order</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">sellOrders</span><span class="hl-1"> = </span><span class="hl-4">orders</span><span class="hl-1">.</span><span class="hl-4">body</span><span class="hl-1">.</span><span class="hl-0">filter</span><span class="hl-1">((</span><span class="hl-4">o</span><span class="hl-1">: </span><span class="hl-10">any</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> !</span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">is_buy_order</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><br/><span class="hl-1">    </span><span class="hl-3">return</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-4">bestBuy:</span><span class="hl-1"> </span><span class="hl-4">Math</span><span class="hl-1">.</span><span class="hl-0">max</span><span class="hl-1">(...</span><span class="hl-4">buyOrders</span><span class="hl-1">.</span><span class="hl-0">map</span><span class="hl-1">((</span><span class="hl-4">o</span><span class="hl-1">: </span><span class="hl-10">any</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">price</span><span class="hl-1">)),</span><br/><span class="hl-1">      </span><span class="hl-4">bestSell:</span><span class="hl-1"> </span><span class="hl-4">Math</span><span class="hl-1">.</span><span class="hl-0">min</span><span class="hl-1">(...</span><span class="hl-4">sellOrders</span><span class="hl-1">.</span><span class="hl-0">map</span><span class="hl-1">((</span><span class="hl-4">o</span><span class="hl-1">: </span><span class="hl-10">any</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-4">o</span><span class="hl-1">.</span><span class="hl-4">price</span><span class="hl-1">))</span><br/><span class="hl-1">    };</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:🧪-testing" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🧪 Testing<a href="#md:🧪-testing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:running-tests" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Running Tests<a href="#md:running-tests" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="bash"><span class="hl-5"># Run unit tests</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">test</span><br/><br/><span class="hl-5"># Run unit tests with coverage</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">coverage</span><br/><br/><span class="hl-5"># Run BDD tests (behavioral scenarios)</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">bdd</span><br/><br/><span class="hl-5"># Run specific BDD test suites</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">bdd:alliance</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">bdd:character</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">bdd:market</span><br/><br/><span class="hl-5"># Run all tests</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">test:all</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:🚀-working-examples" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🚀 Working Examples<a href="#md:🚀-working-examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:try-the-examples" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Try the Examples<a href="#md:try-the-examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>ESI.ts includes working examples that demonstrate real API usage:</p>
+<pre><code class="bash"><span class="hl-5"># Run the complete character profile example</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">example</span><br/><br/><span class="hl-5"># Run flexible API usage examples (all 5 approaches)</span><br/><span class="hl-0">npm</span><span class="hl-1"> </span><span class="hl-2">run</span><span class="hl-1"> </span><span class="hl-2">examples:flexible</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:character-profile-example" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Character Profile Example<a href="#md:character-profile-example" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The main example (<code>npm run example</code>) demonstrates:</p>
+<ul>
+<li>✅ Complete character profile assembly</li>
+<li>✅ Parallel API calls for efficiency</li>
+<li>✅ Error handling and graceful degradation</li>
+<li>✅ Resource cleanup</li>
+<li>✅ Performance timing</li>
+</ul>
+<p><strong>Sample Output:</strong></p>
+<pre><code><span class="hl-1">🚀 </span><span class="hl-7">ESI</span><span class="hl-1">.</span><span class="hl-4">ts</span><span class="hl-1"> </span><span class="hl-4">Character</span><span class="hl-1"> </span><span class="hl-4">Profile</span><span class="hl-1"> </span><span class="hl-4">Example</span><br/><span class="hl-1">=====================================</span><br/><br/><span class="hl-1">🔍 </span><span class="hl-4">Gathering</span><span class="hl-1"> </span><span class="hl-4">complete</span><span class="hl-1"> </span><span class="hl-4">profile</span><span class="hl-1"> </span><span class="hl-4">for</span><span class="hl-1"> </span><span class="hl-4">character</span><span class="hl-1"> </span><span class="hl-11">ID</span><span class="hl-1">: </span><span class="hl-8">1689391488</span><br/><span class="hl-1">📋 </span><span class="hl-4">Fetching</span><span class="hl-1"> </span><span class="hl-4">basic</span><span class="hl-1"> </span><span class="hl-4">character</span><span class="hl-1"> </span><span class="hl-4">information</span><span class="hl-1">...</span><br/><span class="hl-1">🚀 </span><span class="hl-4">Fetching</span><span class="hl-1"> </span><span class="hl-4">detailed</span><span class="hl-1"> </span><span class="hl-4">profile</span><span class="hl-1"> </span><span class="hl-4">data</span><span class="hl-1"> </span><span class="hl-6">in</span><span class="hl-1"> </span><span class="hl-4">parallel</span><span class="hl-1">...</span><br/><br/><span class="hl-1">============================================================</span><br/><span class="hl-1">🎯 </span><span class="hl-7">CHARACTER</span><span class="hl-1"> </span><span class="hl-7">PROFILE</span><span class="hl-1"> </span><span class="hl-7">SUMMARY</span><br/><span class="hl-1">============================================================</span><br/><span class="hl-1">👤 </span><span class="hl-11">Name</span><span class="hl-1">: </span><span class="hl-4">deiseman</span><br/><span class="hl-1">🆔 </span><span class="hl-4">Character</span><span class="hl-1"> </span><span class="hl-11">ID</span><span class="hl-1">: </span><span class="hl-8">1689391488</span><br/><span class="hl-1">🎂 </span><span class="hl-11">Birthday</span><span class="hl-1">: </span><span class="hl-8">2</span><span class="hl-1">/</span><span class="hl-8">3</span><span class="hl-1">/</span><span class="hl-8">2008</span><br/><span class="hl-1">⚖️  </span><span class="hl-4">Security</span><span class="hl-1"> </span><span class="hl-11">Status</span><span class="hl-1">: </span><span class="hl-8">0.16</span><br/><br/><span class="hl-1">🏢 </span><span class="hl-11">Corporation</span><span class="hl-1">: </span><span class="hl-4">Brittas</span><span class="hl-1"> </span><span class="hl-4">Empire</span><span class="hl-1"> [</span><span class="hl-7">BREMP</span><span class="hl-1">]</span><br/><span class="hl-1">👥 </span><span class="hl-11">Members</span><span class="hl-1">: </span><span class="hl-8">360</span><br/><span class="hl-1">🤝 </span><span class="hl-11">Alliance</span><span class="hl-1">: </span><span class="hl-4">Pandemic</span><span class="hl-1"> </span><span class="hl-4">Horde</span><span class="hl-1"> [</span><span class="hl-7">REKTD</span><span class="hl-1">]</span><br/><span class="hl-1">📊 </span><span class="hl-11">Founded</span><span class="hl-1">: </span><span class="hl-8">2</span><span class="hl-1">/</span><span class="hl-8">4</span><span class="hl-1">/</span><span class="hl-8">2015</span><br/><br/><span class="hl-1">🖼️  </span><span class="hl-4">Portrait</span><span class="hl-1"> </span><span class="hl-11">URLs</span><span class="hl-1">:</span><br/><span class="hl-1">   📱 64</span><span class="hl-11">x64</span><span class="hl-1">: </span><span class="hl-11">https</span><span class="hl-1">:</span><span class="hl-5">//images.evetech.net/characters/1689391488/portrait?tenant=tranquility&amp;size=64</span><br/><span class="hl-1">   🖥️  128</span><span class="hl-11">x128</span><span class="hl-1">: </span><span class="hl-11">https</span><span class="hl-1">:</span><span class="hl-5">//images.evetech.net/characters/1689391488/portrait?tenant=tranquility&amp;size=128</span><br/><span class="hl-1">   🖼️  256</span><span class="hl-11">x256</span><span class="hl-1">: </span><span class="hl-11">https</span><span class="hl-1">:</span><span class="hl-5">//images.evetech.net/characters/1689391488/portrait?tenant=tranquility&amp;size=256</span><br/><span class="hl-1">   📺 512</span><span class="hl-11">x512</span><span class="hl-1">: </span><span class="hl-11">https</span><span class="hl-1">:</span><span class="hl-5">//images.evetech.net/characters/1689391488/portrait?tenant=tranquility&amp;size=512</span><br/><br/><span class="hl-1">📍 </span><span class="hl-4">Current</span><span class="hl-1"> </span><span class="hl-11">Location</span><span class="hl-1">: </span><span class="hl-0">Unavailable</span><span class="hl-1"> (</span><span class="hl-4">character</span><span class="hl-1"> </span><span class="hl-4">may</span><span class="hl-1"> </span><span class="hl-4">be</span><span class="hl-1"> </span><span class="hl-4">offline</span><span class="hl-1">)</span><br/><span class="hl-1">============================================================</span><br/><br/><span class="hl-1">⏱️  </span><span class="hl-4">Total</span><span class="hl-1"> </span><span class="hl-4">execution</span><span class="hl-1"> </span><span class="hl-11">time</span><span class="hl-1">: 154</span><span class="hl-4">ms</span><br/><span class="hl-1">✅ </span><span class="hl-4">Character</span><span class="hl-1"> </span><span class="hl-4">profile</span><span class="hl-1"> </span><span class="hl-4">retrieved</span><span class="hl-1"> </span><span class="hl-4">successfully</span><span class="hl-1">!</span>
+</code><button>Copy</button></pre>
+<a id="md:flexible-api-examples" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Flexible API Examples<a href="#md:flexible-api-examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><p>The flexible examples (<code>npm run examples:flexible</code>) demonstrate:</p>
+<ul>
+<li>✅ Full ESI Client (all APIs)</li>
+<li>✅ Custom lightweight client (selected APIs)</li>
+<li>✅ Builder pattern usage</li>
+<li>✅ Individual API clients</li>
+<li>✅ Direct API class instantiation</li>
+<li>✅ Performance comparisons</li>
+<li>✅ Microservice example</li>
+</ul>
+<p><strong>Sample Output:</strong></p>
+<pre><code><span class="hl-1">🚀 </span><span class="hl-7">ESI</span><span class="hl-1">.</span><span class="hl-4">ts</span><span class="hl-1"> </span><span class="hl-4">Flexible</span><span class="hl-1"> </span><span class="hl-7">API</span><span class="hl-1"> </span><span class="hl-4">Usage</span><span class="hl-1"> </span><span class="hl-4">Examples</span><br/><span class="hl-1">=====================================</span><br/><br/><span class="hl-1">1️⃣  </span><span class="hl-4">Full</span><span class="hl-1"> </span><span class="hl-7">ESI</span><span class="hl-1"> </span><span class="hl-0">Client</span><span class="hl-1"> (</span><span class="hl-4">All</span><span class="hl-1"> </span><span class="hl-4">APIs</span><span class="hl-1">)</span><br/><span class="hl-1">✅ </span><span class="hl-11">Character</span><span class="hl-1">: </span><span class="hl-0">deiseman</span><span class="hl-1"> (</span><span class="hl-4">using</span><span class="hl-1"> </span><span class="hl-4">full</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">)</span><br/><br/><span class="hl-1">2️⃣  </span><span class="hl-4">Custom</span><span class="hl-1"> </span><span class="hl-4">Lightweight</span><span class="hl-1"> </span><span class="hl-0">Client</span><span class="hl-1"> (</span><span class="hl-4">Selected</span><span class="hl-1"> </span><span class="hl-4">APIs</span><span class="hl-1">)</span><br/><span class="hl-1">✅ </span><span class="hl-11">Character</span><span class="hl-1">: </span><span class="hl-0">deiseman</span><span class="hl-1"> (</span><span class="hl-4">using</span><span class="hl-1"> </span><span class="hl-4">custom</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">)</span><br/><span class="hl-1">📊 </span><span class="hl-4">Enabled</span><span class="hl-1"> </span><span class="hl-11">clients</span><span class="hl-1">: </span><span class="hl-4">characters</span><span class="hl-1">, </span><span class="hl-4">corporations</span><br/><br/><span class="hl-1">3️⃣  </span><span class="hl-4">Builder</span><span class="hl-1"> </span><span class="hl-4">Pattern</span><br/><span class="hl-1">✅ </span><span class="hl-11">Character</span><span class="hl-1">: </span><span class="hl-0">deiseman</span><span class="hl-1"> (</span><span class="hl-4">using</span><span class="hl-1"> </span><span class="hl-4">builder</span><span class="hl-1"> </span><span class="hl-4">pattern</span><span class="hl-1">)</span><br/><br/><span class="hl-1">4️⃣  </span><span class="hl-4">Individual</span><span class="hl-1"> </span><span class="hl-7">API</span><span class="hl-1"> </span><span class="hl-0">Client</span><span class="hl-1"> (</span><span class="hl-4">Ultra</span><span class="hl-1"> </span><span class="hl-4">Lightweight</span><span class="hl-1">)</span><br/><span class="hl-1">✅ </span><span class="hl-11">Character</span><span class="hl-1">: </span><span class="hl-0">deiseman</span><span class="hl-1"> (</span><span class="hl-4">using</span><span class="hl-1"> </span><span class="hl-4">standalone</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">)</span><br/><br/><span class="hl-1">5️⃣  </span><span class="hl-4">Direct</span><span class="hl-1"> </span><span class="hl-7">API</span><span class="hl-1"> </span><span class="hl-4">Class</span><span class="hl-1"> </span><span class="hl-4">Instantiation</span><br/><span class="hl-1">✅ </span><span class="hl-11">Character</span><span class="hl-1">: </span><span class="hl-0">deiseman</span><span class="hl-1"> (</span><span class="hl-4">using</span><span class="hl-1"> </span><span class="hl-4">direct</span><span class="hl-1"> </span><span class="hl-4">instantiation</span><span class="hl-1">)</span><br/><br/><span class="hl-1">🎯 </span><span class="hl-4">Performance</span><span class="hl-1"> </span><span class="hl-4">Comparison</span><br/><span class="hl-1">=========================</span><br/><span class="hl-1">⏱️  </span><span class="hl-4">Startup</span><span class="hl-1"> </span><span class="hl-4">time</span><span class="hl-1"> </span><span class="hl-11">comparison</span><span class="hl-1">:</span><br/><span class="hl-1">   </span><span class="hl-4">Full</span><span class="hl-1"> </span><span class="hl-11">Client</span><span class="hl-1">: 1</span><span class="hl-4">ms</span><br/><span class="hl-1">   </span><span class="hl-4">Custom</span><span class="hl-1"> </span><span class="hl-0">Client</span><span class="hl-1"> (</span><span class="hl-8">1</span><span class="hl-1"> </span><span class="hl-7">API</span><span class="hl-1">): 0</span><span class="hl-4">ms</span><br/><span class="hl-1">   </span><span class="hl-4">Individual</span><span class="hl-1"> </span><span class="hl-11">Client</span><span class="hl-1">: 0</span><span class="hl-4">ms</span><br/><br/><span class="hl-1">💰 </span><span class="hl-4">Microservice</span><span class="hl-1"> </span><span class="hl-11">Example</span><span class="hl-1">: </span><span class="hl-4">Price</span><span class="hl-1"> </span><span class="hl-4">Service</span><br/><span class="hl-1">======================================</span><br/><span class="hl-1">💎 </span><span class="hl-4">Tritanium</span><span class="hl-1"> </span><span class="hl-4">average</span><span class="hl-1"> </span><span class="hl-11">price</span><span class="hl-1">: </span><span class="hl-8">3.78</span><span class="hl-1"> </span><span class="hl-7">ISK</span>
+</code><button>Copy</button></pre>
+<a id="md:example-files" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Example Files<a href="#md:example-files" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><table>
+<thead>
+<tr>
+<th>File</th>
+<th>Purpose</th>
+<th>Command</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>src/index.ts</code></td>
+<td>Character profile assembly</td>
+<td><code>npm run example</code></td>
+</tr>
+<tr>
+<td><code>demo/flexible-examples.ts</code></td>
+<td>All flexible API patterns</td>
+<td><code>npm run examples:flexible</code></td>
+</tr>
+</tbody>
+</table>
+<a id="md:learning-path" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Learning Path<a href="#md:learning-path" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><ol>
+<li><strong>Start Here</strong>: Run <code>npm run example</code> to see a complete real-world workflow</li>
+<li><strong>Explore Options</strong>: Run <code>npm run examples:flexible</code> to see all the different ways to use the API</li>
+<li><strong>Choose Your Approach</strong>: Pick the method that best fits your use case</li>
+<li><strong>Build Your App</strong>: Use the examples as templates for your own application</li>
+</ol>
+<a id="md:testing-your-applications" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Testing Your Applications<a href="#md:testing-your-applications" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">EsiClient</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><span class="hl-3">import</span><span class="hl-1"> { </span><span class="hl-4">TestDataFactory</span><span class="hl-1"> } </span><span class="hl-3">from</span><span class="hl-1"> </span><span class="hl-2">&#39;@lgriffin/esi.ts&#39;</span><span class="hl-1">;</span><br/><br/><span class="hl-0">describe</span><span class="hl-1">(</span><span class="hl-2">&#39;My EVE Application&#39;</span><span class="hl-1">, () </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">let</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">: </span><span class="hl-10">EsiClient</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-0">beforeEach</span><span class="hl-1">(() </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-4">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">      </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;test-client&#39;</span><br/><span class="hl-1">    });</span><br/><span class="hl-1">  });</span><br/><br/><span class="hl-1">  </span><span class="hl-0">afterEach</span><span class="hl-1">(</span><span class="hl-6">async</span><span class="hl-1"> () </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">shutdown</span><span class="hl-1">();</span><br/><span class="hl-1">  });</span><br/><br/><span class="hl-1">  </span><span class="hl-0">it</span><span class="hl-1">(</span><span class="hl-2">&#39;should handle character lookup&#39;</span><span class="hl-1">, </span><span class="hl-6">async</span><span class="hl-1"> () </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">// Mock data for testing</span><br/><span class="hl-1">    </span><span class="hl-4">jest</span><span class="hl-1">.</span><span class="hl-0">spyOn</span><span class="hl-1">(</span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">, </span><span class="hl-2">&#39;getCharacterPublicInfo&#39;</span><span class="hl-1">)</span><br/><span class="hl-1">      .</span><span class="hl-0">mockResolvedValue</span><span class="hl-1">(</span><span class="hl-4">TestDataFactory</span><span class="hl-1">.</span><span class="hl-0">createCharacterInfo</span><span class="hl-1">({</span><br/><span class="hl-1">        </span><span class="hl-4">character_id:</span><span class="hl-1"> </span><span class="hl-8">123456</span><span class="hl-1">,</span><br/><span class="hl-1">        </span><span class="hl-4">name:</span><span class="hl-1"> </span><span class="hl-2">&#39;Test Character&#39;</span><br/><span class="hl-1">      }));</span><br/><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">character</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">characters</span><span class="hl-1">.</span><span class="hl-0">getCharacterPublicInfo</span><span class="hl-1">(</span><span class="hl-8">123456</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-0">expect</span><span class="hl-1">(</span><span class="hl-4">character</span><span class="hl-1">.</span><span class="hl-4">name</span><span class="hl-1">).</span><span class="hl-0">toBe</span><span class="hl-1">(</span><span class="hl-2">&#39;Test Character&#39;</span><span class="hl-1">);</span><br/><span class="hl-1">  });</span><br/><span class="hl-1">});</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:🛠️-resource-management" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🛠️ Resource Management<a href="#md:🛠️-resource-management" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><a id="md:proper-cleanup" class="tsd-anchor"></a><h3 class="tsd-anchor-link">Proper Cleanup<a href="#md:proper-cleanup" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h3><pre><code class="typescript"><span class="hl-5">// Always clean up resources when done</span><br/><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-6">function</span><span class="hl-1"> </span><span class="hl-0">myApplication</span><span class="hl-1">() {</span><br/><span class="hl-1">  </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">({</span><br/><span class="hl-1">    </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;my-app&#39;</span><br/><span class="hl-1">  });</span><br/><br/><span class="hl-1">  </span><span class="hl-3">try</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">// Your application logic here</span><br/><span class="hl-1">    </span><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">alliance</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">alliance</span><span class="hl-1">.</span><span class="hl-0">getAllianceById</span><span class="hl-1">(</span><span class="hl-8">99005338</span><span class="hl-1">);</span><br/><span class="hl-1">    </span><span class="hl-4">console</span><span class="hl-1">.</span><span class="hl-0">log</span><span class="hl-1">(</span><span class="hl-4">alliance</span><span class="hl-1">.</span><span class="hl-4">name</span><span class="hl-1">);</span><br/><span class="hl-1">  } </span><span class="hl-3">finally</span><span class="hl-1"> {</span><br/><span class="hl-1">    </span><span class="hl-5">// Important: Always shutdown the client</span><br/><span class="hl-1">    </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">shutdown</span><span class="hl-1">();</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-5">// Or use a try-with-resources pattern</span><br/><span class="hl-6">class</span><span class="hl-1"> </span><span class="hl-10">EsiClientManager</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-6">private</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">: </span><span class="hl-10">EsiClient</span><span class="hl-1">;</span><br/><br/><span class="hl-1">  </span><span class="hl-6">constructor</span><span class="hl-1">(</span><span class="hl-4">config</span><span class="hl-1">: </span><span class="hl-10">any</span><span class="hl-1">) {</span><br/><span class="hl-1">    </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClient</span><span class="hl-1">(</span><span class="hl-4">config</span><span class="hl-1">);</span><br/><span class="hl-1">  }</span><br/><br/><span class="hl-1">  </span><span class="hl-6">async</span><span class="hl-1"> </span><span class="hl-0">use</span><span class="hl-1">&lt;</span><span class="hl-10">T</span><span class="hl-1">&gt;(</span><span class="hl-0">callback</span><span class="hl-1">: (</span><span class="hl-4">client</span><span class="hl-1">: </span><span class="hl-10">EsiClient</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> </span><span class="hl-10">Promise</span><span class="hl-1">&lt;</span><span class="hl-10">T</span><span class="hl-1">&gt;): </span><span class="hl-10">Promise</span><span class="hl-1">&lt;</span><span class="hl-10">T</span><span class="hl-1">&gt; {</span><br/><span class="hl-1">    </span><span class="hl-3">try</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-0">callback</span><span class="hl-1">(</span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1">);</span><br/><span class="hl-1">    } </span><span class="hl-3">finally</span><span class="hl-1"> {</span><br/><span class="hl-1">      </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-6">this</span><span class="hl-1">.</span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-0">shutdown</span><span class="hl-1">();</span><br/><span class="hl-1">    }</span><br/><span class="hl-1">  }</span><br/><span class="hl-1">}</span><br/><br/><span class="hl-5">// Usage</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">manager</span><span class="hl-1"> = </span><span class="hl-6">new</span><span class="hl-1"> </span><span class="hl-0">EsiClientManager</span><span class="hl-1">({ </span><span class="hl-4">clientId:</span><span class="hl-1"> </span><span class="hl-2">&#39;my-app&#39;</span><span class="hl-1"> });</span><br/><span class="hl-6">const</span><span class="hl-1"> </span><span class="hl-7">result</span><span class="hl-1"> = </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">manager</span><span class="hl-1">.</span><span class="hl-0">use</span><span class="hl-1">(</span><span class="hl-6">async</span><span class="hl-1"> (</span><span class="hl-4">client</span><span class="hl-1">) </span><span class="hl-6">=&gt;</span><span class="hl-1"> {</span><br/><span class="hl-1">  </span><span class="hl-3">return</span><span class="hl-1"> </span><span class="hl-3">await</span><span class="hl-1"> </span><span class="hl-4">client</span><span class="hl-1">.</span><span class="hl-4">alliance</span><span class="hl-1">.</span><span class="hl-0">getAllianceById</span><span class="hl-1">(</span><span class="hl-8">99005338</span><span class="hl-1">);</span><br/><span class="hl-1">});</span>
+</code><button type="button">Copy</button></pre>
+<a id="md:🤝-contributing" class="tsd-anchor"></a><h2 class="tsd-anchor-link">🤝 Contributing<a href="#md:🤝-contributing" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><ol>
+<li>Fork the repository</li>
+<li>Create a feature branch</li>
+<li>Write tests for your changes</li>
+<li>Ensure all tests pass: <code>npm test &amp;&amp; npm run bdd</code></li>
+<li>Open a Pull Request</li>
+</ol>
+<a id="md:📄-license" class="tsd-anchor"></a><h2 class="tsd-anchor-link">📄 License<a href="#md:📄-license" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2><p>GPL-3.0-or-later - see the <a href="media/LICENSE">LICENSE</a> file for details.</p>
+<hr>
+<p><strong>Happy coding, capsuleers! o7</strong></p>
+</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="assets/icons.svg#icon-chevronDown"></use></svg>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><h3><svg width="20" height="20" viewBox="0 0 24 24" fill="none"><use href="assets/icons.svg#icon-chevronDown"></use></svg>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#md:esits"><span>ESI.ts</span></a><ul><li><a href="#md:🚀-features"><span>🚀 <wbr/>Features</span></a></li><li><a href="#md:📦-installation"><span>📦 <wbr/>Installation</span></a></li><li><a href="#md:🔧-getting-started"><span>🔧 <wbr/>Getting <wbr/>Started</span></a></li><li><ul><li><a href="#md:1-full-esi-client-all-apis"><span>1. <wbr/>Full ESI <wbr/>Client (<wbr/>All APIs)</span></a></li><li><a href="#md:2-custom-lightweight-client-selected-apis"><span>2. <wbr/>Custom <wbr/>Lightweight <wbr/>Client (<wbr/>Selected APIs)</span></a></li><li><a href="#md:3-builder-pattern-for-custom-clients"><span>3. <wbr/>Builder <wbr/>Pattern for <wbr/>Custom <wbr/>Clients</span></a></li><li><a href="#md:4-individual-api-clients-ultra-lightweight"><span>4. <wbr/>Individual API <wbr/>Clients (<wbr/>Ultra <wbr/>Lightweight)</span></a></li><li><a href="#md:5-direct-api-class-instantiation"><span>5. <wbr/>Direct API <wbr/>Class <wbr/>Instantiation</span></a></li></ul></li><li><a href="#md:📊-client-architecture"><span>📊 <wbr/>Client <wbr/>Architecture</span></a></li><li><ul><li><a href="#md:available-client-types"><span>Available <wbr/>Client <wbr/>Types</span></a></li></ul></li><li><a href="#md:🎯-choosing-the-right-approach"><span>🎯 <wbr/>Choosing the <wbr/>Right <wbr/>Approach</span></a></li><li><ul><li><a href="#md:when-to-use-each-method"><span>When to <wbr/>Use <wbr/>Each <wbr/>Method</span></a></li><li><a href="#md:practical-examples-by-use-case"><span>Practical <wbr/>Examples by <wbr/>Use <wbr/>Case</span></a></li><li><ul><li><a href="#md:character-lookup-tool-ultra-lightweight"><span>Character <wbr/>Lookup <wbr/>Tool (<wbr/>Ultra <wbr/>Lightweight)</span></a></li><li><a href="#md:trading-bot-selected-apis"><span>Trading <wbr/>Bot (<wbr/>Selected APIs)</span></a></li><li><a href="#md:corporation-management-dashboard-custom-client"><span>Corporation <wbr/>Management <wbr/>Dashboard (<wbr/>Custom <wbr/>Client)</span></a></li></ul></li></ul></li><li><a href="#md:📋-common-usage-patterns"><span>📋 <wbr/>Common <wbr/>Usage <wbr/>Patterns</span></a></li><li><ul><li><a href="#md:public-data-no-authentication-required"><span>Public <wbr/>Data (<wbr/>No <wbr/>Authentication <wbr/>Required)</span></a></li><li><a href="#md:authenticated-data-access-token-required"><span>Authenticated <wbr/>Data (<wbr/>Access <wbr/>Token <wbr/>Required)</span></a></li><li><a href="#md:complex-workflows"><span>Complex <wbr/>Workflows</span></a></li></ul></li><li><a href="#md:📊-error-handling"><span>📊 <wbr/>Error <wbr/>Handling</span></a></li><li><ul><li><a href="#md:graceful-error-handling-in-complex-workflows"><span>Graceful <wbr/>Error <wbr/>Handling in <wbr/>Complex <wbr/>Workflows</span></a></li></ul></li><li><a href="#md:⚡-performance--caching"><span>⚡ <wbr/>Performance &amp; <wbr/>Caching</span></a></li><li><ul><li><a href="#md:intelligent-etag-caching"><span>Intelligent ETag <wbr/>Caching</span></a></li><li><ul><li><a href="#md:how-etag-caching-works"><span>How ETag <wbr/>Caching <wbr/>Works</span></a></li><li><a href="#md:basic-usage-automatic"><span>Basic <wbr/>Usage (<wbr/>Automatic)</span></a></li><li><a href="#md:custom-cache-configuration"><span>Custom <wbr/>Cache <wbr/>Configuration</span></a></li><li><a href="#md:cache-management"><span>Cache <wbr/>Management</span></a></li><li><a href="#md:performance-benefits"><span>Performance <wbr/>Benefits</span></a></li><li><a href="#md:cache-behavior"><span>Cache <wbr/>Behavior</span></a></li><li><a href="#md:advanced-etag-features"><span>Advanced ETag <wbr/>Features</span></a></li><li><a href="#md:when-etag-caching-helps-most"><span>When ETag <wbr/>Caching <wbr/>Helps <wbr/>Most</span></a></li><li><a href="#md:implementation-details"><span>Implementation <wbr/>Details</span></a></li></ul></li></ul></li><li><a href="#md:🔧-advanced-configuration"><span>🔧 <wbr/>Advanced <wbr/>Configuration</span></a></li><li><ul><li><a href="#md:custom-timeout-and-retry-logic"><span>Custom <wbr/>Timeout and <wbr/>Retry <wbr/>Logic</span></a></li><li><a href="#md:using-environment-variables"><span>Using <wbr/>Environment <wbr/>Variables</span></a></li></ul></li><li><a href="#md:🚀-real-world-examples"><span>🚀 <wbr/>Real-<wbr/>World <wbr/>Examples</span></a></li><li><ul><li><a href="#md:eve-market-trading-bot-lightweight-version"><span>EVE <wbr/>Market <wbr/>Trading <wbr/>Bot (<wbr/>Lightweight <wbr/>Version)</span></a></li><li><a href="#md:corporation-management-dashboard-custom-client-1"><span>Corporation <wbr/>Management <wbr/>Dashboard (<wbr/>Custom <wbr/>Client)</span></a></li><li><a href="#md:simple-character-lookup-direct-api"><span>Simple <wbr/>Character <wbr/>Lookup (<wbr/>Direct API)</span></a></li><li><a href="#md:direct-api-class-usage"><span>Direct API <wbr/>Class <wbr/>Usage</span></a></li><li><a href="#md:microservice-example-single-responsibility"><span>Microservice <wbr/>Example (<wbr/>Single <wbr/>Responsibility)</span></a></li></ul></li><li><a href="#md:🧪-testing"><span>🧪 <wbr/>Testing</span></a></li><li><ul><li><a href="#md:running-tests"><span>Running <wbr/>Tests</span></a></li></ul></li><li><a href="#md:🚀-working-examples"><span>🚀 <wbr/>Working <wbr/>Examples</span></a></li><li><ul><li><a href="#md:try-the-examples"><span>Try the <wbr/>Examples</span></a></li><li><a href="#md:character-profile-example"><span>Character <wbr/>Profile <wbr/>Example</span></a></li><li><a href="#md:flexible-api-examples"><span>Flexible API <wbr/>Examples</span></a></li><li><a href="#md:example-files"><span>Example <wbr/>Files</span></a></li><li><a href="#md:learning-path"><span>Learning <wbr/>Path</span></a></li><li><a href="#md:testing-your-applications"><span>Testing <wbr/>Your <wbr/>Applications</span></a></li></ul></li><li><a href="#md:🛠️-resource-management"><span>🛠️ <wbr/>Resource <wbr/>Management</span></a></li><li><ul><li><a href="#md:proper-cleanup"><span>Proper <wbr/>Cleanup</span></a></li></ul></li><li><a href="#md:🤝-contributing"><span>🤝 <wbr/>Contributing</span></a></li><li><a href="#md:📄-license"><span>📄 <wbr/>License</span></a></li></ul></div></details></div><div class="site-menu"><nav id="tsd-sidebar-links" class="tsd-navigation"><a href="https://esi.evetech.net/ui/">ESI Documentation</a><a href="https://www.eveonline.com/">EVE Online</a><a href="https://github.com/lgriffin/ESI.ts" class="tsd-nav-link">GitHub</a><a href="https://www.npmjs.com/package/@lgriffin/esi.ts" class="tsd-nav-link">NPM</a></nav><nav class="tsd-navigation"><a href="modules.html" class="current"><svg class="tsd-kind-icon" viewBox="0 0 24 24"><use href="assets/icons.svg#icon-1"></use></svg><span>@lgriffin/esi.ts - EVE Online ESI API Client - v1.0.0</span></a><ul class="tsd-small-nested-navigation" id="tsd-nav-container" data-base="."><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>