lunassets 1.0.0

package/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish
+
+on:
+  push:
+    branches: [main]
+    paths: ["package.json"]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: "npm"
+      - run: npm ci
+      - run: npm run build
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' || github.event_name == 'workflow_dispatch'
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20.x"
+          cache: "npm"
+          registry-url: "https://registry.npmjs.org"
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/LICENSE

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

package/README.md

@@ -0,0 +1,143 @@
+# Lunassets
+
+Luna's TypeScript library wrapper for asset management from Enka Network API.
+
+## Installation
+
+```bash
+npm install lunassets
+```
+
+## Quick Start
+
+```typescript
+import { EnkaAssetWrapper } from "lunassets";
+
+async function getPlayerData() {
+  const enka = new EnkaAssetWrapper();
+
+  try {
+    const assets = await enka.getPlayerAssets("856012067");
+    console.log(assets);
+  } catch (error) {
+    console.error("Error:", error.message);
+  }
+}
+
+getPlayerData();
+```
+
+## Example Response
+
+```json
+{
+  "playerInfo": {
+    "nickname": "Kiznavierr",
+    "level": 60,
+    "signature": "sometimes even reality is a lie",
+    "worldLevel": 9,
+    "finishAchievementNum": 1366,
+    "towerFloorIndex": 12,
+    "towerLevelIndex": 3,
+    "theaterActIndex": 10,
+    "theaterModeIndex": 83,
+    "theaterStarIndex": 10,
+    "isShowAvatarTalent": true,
+    "fetterCount": 33,
+    "towerStarIndex": 35,
+    "stygianIndex": 3,
+    "stygianSeconds": 79,
+    "stygianId": 5269006
+  },
+  "profilePicture": {
+    "id": 7300,
+    "iconName": "/ui/UI_AvatarIcon_Charlotte_Circle.png",
+    "url": "https://enka.network/ui/UI_AvatarIcon_Charlotte_Circle.png"
+  },
+  "nameCard": {
+    "id": 210214,
+    "iconName": "UI_NameCardPic_RoleCombat2_P",
+    "url": "https://enka.network/ui/UI_NameCardPic_RoleCombat2_P.png"
+  },
+  "showAvatars": [
+    {
+      "avatarId": 10000047,
+      "iconName": "UI_AvatarIcon_Kazuha",
+      "url": "https://enka.network/ui/UI_AvatarIcon_Kazuha.png",
+      "quality": 5,
+      "level": 90,
+      "talentLevel": 2,
+      "element": "Wind",
+      "weaponType": "WEAPON_SWORD_ONE_HAND"
+    }
+  ],
+  "ttl": 60,
+  "lastUpdated": "2026-02-15T04:51:05.385Z"
+}
+```
+
+## API Methods
+
+### getPlayerAssets(uid)
+
+```typescript
+const assets = await enka.getPlayerAssets("123456789");
+```
+
+### getPlayerAssetsUncached(uid)
+
+```typescript
+const assets = await enka.getPlayerAssetsUncached("123456789");
+```
+
+### buildAssetUrl(iconName, options)
+
+```typescript
+const url = enka.buildAssetUrl("UI_AvatarIcon_Ayaka");
+```
+
+### Cache Management
+
+```typescript
+// Check if player data is cached
+const isCached = enka.isPlayerCached("123456789");
+
+// Clear specific player cache
+enka.clearPlayerCache("123456789");
+
+// Clear all cache
+enka.clearAllCache();
+```
+
+### Data Validation
+
+```typescript
+// Check if character exists in reference data
+const hasCharacter = await enka.hasCharacter(10000002);
+
+// Check if profile picture exists
+const hasPfp = await enka.hasProfilePicture(7300);
+
+// Check if name card exists
+const hasNameCard = await enka.hasNameCard(210214);
+```
+
+## Error Handling
+
+```typescript
+import { EnkaApiError, EnkaMappingError } from "lunassets";
+
+try {
+  const assets = await enka.getPlayerAssets("123456");
+} catch (error) {
+  if (error instanceof EnkaApiError) {
+    console.error("API Error:", error.message);
+  } else if (error instanceof EnkaMappingError) {
+    console.error("Mapping Error:", error.message);
+  }
+}
+```
+
+## License
+
+See the [LICENSE](LICENSE) file for details.

package/dist/core/api-client.d.ts

@@ -0,0 +1,22 @@
+import { EnkaApiResponse, FetchPlayerParams, EnkaAssetConfig } from "../types";
+export declare class EnkaApiClient {
+    private config;
+    constructor(config?: Partial<EnkaAssetConfig>);
+    /**
+     * Fetch player data from Enka Network API
+     */
+    fetchPlayerData(params: FetchPlayerParams): Promise<EnkaApiResponse>;
+    /**
+     * Get player data with rate limiting awareness
+     */
+    getPlayerData(uid: string | number): Promise<EnkaApiResponse>;
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig: Partial<EnkaAssetConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): EnkaAssetConfig;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/core/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,iBAAiB,EAEjB,eAAe,EAChB,MAAM,UAAU,CAAC;AAGlB,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAO7C;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IA2C1E;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAenE;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAOvD;;OAEG;IACH,SAAS,IAAI,eAAe;CAG7B"}

package/dist/core/api-client.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnkaApiClient = void 0;
+const types_1 = require("../types");
+const utils_1 = require("../utils");
+class EnkaApiClient {
+    constructor(config) {
+        this.config = {
+            ...utils_1.DEFAULT_CONFIG,
+            ...config,
+        };
+    }
+    /**
+     * Fetch player data from Enka Network API
+     */
+    async fetchPlayerData(params) {
+        const { uid, info = true } = params;
+        // Build URL
+        const url = `${this.config.apiUrl}/uid/${uid}${info ? "?info" : ""}`;
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    "User-Agent": this.config.userAgent || utils_1.DEFAULT_CONFIG.userAgent,
+                },
+                // Note: timeout handling can be done with AbortController if needed
+            });
+            if (!response.ok) {
+                throw new types_1.EnkaApiError(`API request failed: ${response.status} ${response.statusText}`, response.status);
+            }
+            const data = (await response.json());
+            // Validate response structure
+            if (!data.playerInfo) {
+                throw new types_1.EnkaApiError("Invalid API response: missing playerInfo");
+            }
+            return data;
+        }
+        catch (error) {
+            if (error instanceof types_1.EnkaApiError) {
+                throw error;
+            }
+            // Network atau parsing errors
+            if (error instanceof Error) {
+                throw new types_1.EnkaApiError(`Network error: ${error.message}`);
+            }
+            throw new types_1.EnkaApiError("Unknown API error");
+        }
+    }
+    /**
+     * Get player data with rate limiting awareness
+     */
+    async getPlayerData(uid) {
+        try {
+            return await this.fetchPlayerData({ uid, info: true });
+        }
+        catch (error) {
+            if (error instanceof types_1.EnkaApiError && error.statusCode === 429) {
+                // Rate limited, bisa implement retry atau throw dengan pesan yang lebih friendly
+                throw new types_1.EnkaApiError("Rate limited by Enka API. Please try again later.", 429);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(newConfig) {
+        this.config = {
+            ...this.config,
+            ...newConfig,
+        };
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.EnkaApiClient = EnkaApiClient;
+//# sourceMappingURL=api-client.js.map

package/dist/core/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.js","sourceRoot":"","sources":["../../src/core/api-client.ts"],"names":[],"mappings":";;;AAAA,oCAKkB;AAClB,oCAA0C;AAE1C,MAAa,aAAa;IAGxB,YAAY,MAAiC;QAC3C,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,sBAAc;YACjB,GAAG,MAAM;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,MAAyB;QAC7C,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAEpC,YAAY;QACZ,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,OAAO,EAAE;oBACP,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,sBAAc,CAAC,SAAS;iBAChE;gBACD,oEAAoE;aACrE,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,oBAAY,CACpB,uBAAuB,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EAC/D,QAAQ,CAAC,MAAM,CAChB,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;YAExD,8BAA8B;YAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,IAAI,oBAAY,CAAC,0CAA0C,CAAC,CAAC;YACrE,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,oBAAY,EAAE,CAAC;gBAClC,MAAM,KAAK,CAAC;YACd,CAAC;YAED,8BAA8B;YAC9B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,oBAAY,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC5D,CAAC;YAED,MAAM,IAAI,oBAAY,CAAC,mBAAmB,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,GAAoB;QACtC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,oBAAY,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,EAAE,CAAC;gBAC9D,iFAAiF;gBACjF,MAAM,IAAI,oBAAY,CACpB,mDAAmD,EACnD,GAAG,CACJ,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAmC;QAC9C,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,SAAS;SACb,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF;AA1FD,sCA0FC"}

package/dist/core/asset-mapper.d.ts

@@ -0,0 +1,106 @@
+import { EnkaApiResponse, ProcessedPlayerAssets } from "../types";
+import { EnkaUrlBuilder } from "./url-builder";
+export declare class EnkaAssetMapper {
+    private dataFetcher;
+    private urlBuilder;
+    constructor(urlBuilder: EnkaUrlBuilder);
+    /**
+     * Map API response to processed player assets
+     */
+    mapPlayerAssets(apiResponse: EnkaApiResponse): Promise<ProcessedPlayerAssets>;
+    /**
+     * Map profile picture ID to processed profile picture
+     */
+    private mapProfilePicture;
+    /**
+     * Map name card ID to processed name card
+     */
+    private mapNameCard;
+    /**
+     * Map avatar ID to processed show avatar
+     */
+    private mapShowAvatar;
+    /**
+     * Get character data by ID
+     */
+    getCharacterData(avatarId: number): Promise<{
+        Element: string;
+        Consts: string[];
+        SkillOrder: number[];
+        Skills: {
+            [skillId: string]: string;
+        };
+        ProudMap: {
+            [skillId: string]: number;
+        };
+        NameTextMapHash: number;
+        SideIconName: string;
+        QualityType: "QUALITY_ORANGE" | "QUALITY_PURPLE";
+        WeaponType: string;
+        Costumes?: {
+            [costumeId: string]: {
+                sideIconName: string;
+                icon: string;
+                art: string;
+                avatarId: number;
+            };
+        };
+    }>;
+    /**
+     * Get profile picture data by ID
+     */
+    getProfilePictureData(pfpId: number): Promise<{
+        IconPath: string;
+    }>;
+    /**
+     * Get name card data by ID
+     */
+    getNameCardData(nameCardId: number): Promise<{
+        icon: string;
+    }>;
+    /**
+     * Check if character exists
+     */
+    hasCharacter(avatarId: number): Promise<boolean>;
+    /**
+     * Check if profile picture exists
+     */
+    hasProfilePicture(pfpId: number): Promise<boolean>;
+    /**
+     * Check if name card exists
+     */
+    hasNameCard(nameCardId: number): Promise<boolean>;
+    /**
+     * Get statistics about loaded data
+     */
+    getDataStats(): Promise<{
+        characters: number;
+        profilePictures: number;
+        nameCards: number;
+    }>;
+    /**
+     * Get data fetcher cache info
+     */
+    getDataCacheInfo(): {
+        characters: {
+            cached: boolean;
+            age: number;
+            expired: boolean;
+        };
+        pfps: {
+            cached: boolean;
+            age: number;
+            expired: boolean;
+        };
+        namecards: {
+            cached: boolean;
+            age: number;
+            expired: boolean;
+        };
+    };
+    /**
+     * Clear reference data cache
+     */
+    clearDataCache(): void;
+}
+//# sourceMappingURL=asset-mapper.d.ts.map

package/dist/core/asset-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-mapper.d.ts","sourceRoot":"","sources":["../../src/core/asset-mapper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EAIf,qBAAqB,EAKtB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG/C,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,UAAU,CAAiB;gBAEvB,UAAU,EAAE,cAAc;IAKtC;;OAEG;IACG,eAAe,CACnB,WAAW,EAAE,eAAe,GAC3B,OAAO,CAAC,qBAAqB,CAAC;IA6CjC;;OAEG;YACW,iBAAiB;IAuB/B;;OAEG;YACW,WAAW;IAoBzB;;OAEG;YACW,aAAa;IAoC3B;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;IAKvC;;OAEG;IACG,qBAAqB,CAAC,KAAK,EAAE,MAAM;;;IAKzC;;OAEG;IACG,eAAe,CAAC,UAAU,EAAE,MAAM;;;IAKxC;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKtD;;OAEG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxD;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvD;;OAEG;IACG,YAAY;;;;;IAclB;;OAEG;IACH,gBAAgB;;;;;;;;;;;;;;;;;IAIhB;;OAEG;IACH,cAAc,IAAI,IAAI;CAGvB"}

package/dist/core/asset-mapper.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnkaAssetMapper = void 0;
+const types_1 = require("../types");
+const utils_1 = require("../utils");
+const data_fetcher_1 = require("./data-fetcher");
+class EnkaAssetMapper {
+    constructor(urlBuilder) {
+        this.dataFetcher = new data_fetcher_1.EnkaDataFetcher();
+        this.urlBuilder = urlBuilder;
+    }
+    /**
+     * Map API response to processed player assets
+     */
+    async mapPlayerAssets(apiResponse) {
+        const { playerInfo } = apiResponse;
+        // Process profile picture
+        const profilePicture = await this.mapProfilePicture(playerInfo.profilePicture.id);
+        // Process name card
+        const nameCard = await this.mapNameCard(playerInfo.nameCardId);
+        // Process show avatars
+        const showAvatars = await Promise.all(playerInfo.showAvatarInfoList.map((avatar) => this.mapShowAvatar(avatar.avatarId, avatar.level, avatar.talentLevel)));
+        return {
+            playerInfo: {
+                nickname: playerInfo.nickname,
+                level: playerInfo.level,
+                signature: playerInfo.signature,
+                worldLevel: playerInfo.worldLevel,
+                finishAchievementNum: playerInfo.finishAchievementNum,
+                towerFloorIndex: playerInfo.towerFloorIndex,
+                towerLevelIndex: playerInfo.towerLevelIndex,
+                theaterActIndex: playerInfo.theaterActIndex,
+                theaterModeIndex: playerInfo.theaterModeIndex,
+                theaterStarIndex: playerInfo.theaterStarIndex,
+                isShowAvatarTalent: playerInfo.isShowAvatarTalent,
+                fetterCount: playerInfo.fetterCount,
+                towerStarIndex: playerInfo.towerStarIndex,
+                stygianIndex: playerInfo.stygianIndex,
+                stygianSeconds: playerInfo.stygianSeconds,
+                stygianId: playerInfo.stygianId,
+            },
+            profilePicture,
+            nameCard,
+            showAvatars,
+            ttl: apiResponse.ttl,
+            lastUpdated: new Date(),
+        };
+    }
+    /**
+     * Map profile picture ID to processed profile picture
+     */
+    async mapProfilePicture(pfpId) {
+        const pfpsData = await this.dataFetcher.getPfpsData();
+        const pfpData = pfpsData[pfpId.toString()];
+        if (!pfpData) {
+            throw new types_1.EnkaMappingError(`Profile picture not found for ID: ${pfpId}`, pfpId);
+        }
+        // IconPath di pfps.json sudah include full path dan extension
+        const url = `https://enka.network${pfpData.IconPath}`;
+        return {
+            id: pfpId,
+            iconName: pfpData.IconPath,
+            url,
+        };
+    }
+    /**
+     * Map name card ID to processed name card
+     */
+    async mapNameCard(nameCardId) {
+        const namecardsData = await this.dataFetcher.getNamecardsData();
+        const nameCardData = namecardsData[nameCardId.toString()];
+        if (!nameCardData) {
+            throw new types_1.EnkaMappingError(`Name card not found for ID: ${nameCardId}`, nameCardId);
+        }
+        const url = this.urlBuilder.buildNameCardUrl(nameCardData.icon);
+        return {
+            id: nameCardId,
+            iconName: nameCardData.icon,
+            url,
+        };
+    }
+    /**
+     * Map avatar ID to processed show avatar
+     */
+    async mapShowAvatar(avatarId, level, talentLevel) {
+        const charactersData = await this.dataFetcher.getCharactersData();
+        const characterData = charactersData[avatarId.toString()];
+        if (!characterData) {
+            throw new types_1.EnkaMappingError(`Character not found for ID: ${avatarId}`, avatarId);
+        }
+        // Transform SideIconName (hilangkan "Side_")
+        const iconName = (0, utils_1.transformIconName)(characterData.SideIconName);
+        // Convert quality type to numeric
+        const quality = (0, utils_1.getQualityNumeric)(characterData.QualityType);
+        // Build URL
+        const url = this.urlBuilder.buildCharacterIconUrl(iconName);
+        return {
+            avatarId,
+            iconName,
+            url,
+            quality,
+            level,
+            talentLevel,
+            element: characterData.Element,
+            weaponType: characterData.WeaponType,
+        };
+    }
+    /**
+     * Get character data by ID
+     */
+    async getCharacterData(avatarId) {
+        const charactersData = await this.dataFetcher.getCharactersData();
+        return charactersData[avatarId.toString()] || null;
+    }
+    /**
+     * Get profile picture data by ID
+     */
+    async getProfilePictureData(pfpId) {
+        const pfpsData = await this.dataFetcher.getPfpsData();
+        return pfpsData[pfpId.toString()] || null;
+    }
+    /**
+     * Get name card data by ID
+     */
+    async getNameCardData(nameCardId) {
+        const namecardsData = await this.dataFetcher.getNamecardsData();
+        return namecardsData[nameCardId.toString()] || null;
+    }
+    /**
+     * Check if character exists
+     */
+    async hasCharacter(avatarId) {
+        const charactersData = await this.dataFetcher.getCharactersData();
+        return avatarId.toString() in charactersData;
+    }
+    /**
+     * Check if profile picture exists
+     */
+    async hasProfilePicture(pfpId) {
+        const pfpsData = await this.dataFetcher.getPfpsData();
+        return pfpId.toString() in pfpsData;
+    }
+    /**
+     * Check if name card exists
+     */
+    async hasNameCard(nameCardId) {
+        const namecardsData = await this.dataFetcher.getNamecardsData();
+        return nameCardId.toString() in namecardsData;
+    }
+    /**
+     * Get statistics about loaded data
+     */
+    async getDataStats() {
+        const [charactersData, pfpsData, namecardsData] = await Promise.all([
+            this.dataFetcher.getCharactersData(),
+            this.dataFetcher.getPfpsData(),
+            this.dataFetcher.getNamecardsData(),
+        ]);
+        return {
+            characters: Object.keys(charactersData).length,
+            profilePictures: Object.keys(pfpsData).length,
+            nameCards: Object.keys(namecardsData).length,
+        };
+    }
+    /**
+     * Get data fetcher cache info
+     */
+    getDataCacheInfo() {
+        return this.dataFetcher.getCacheInfo();
+    }
+    /**
+     * Clear reference data cache
+     */
+    clearDataCache() {
+        this.dataFetcher.clearCache();
+    }
+}
+exports.EnkaAssetMapper = EnkaAssetMapper;
+//# sourceMappingURL=asset-mapper.js.map

package/dist/core/asset-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-mapper.js","sourceRoot":"","sources":["../../src/core/asset-mapper.ts"],"names":[],"mappings":"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"}

package/dist/core/cache-manager.d.ts

@@ -0,0 +1,64 @@
+import { EnkaAssetConfig } from "../types";
+export declare class EnkaCacheManager {
+    private cache;
+    private config;
+    constructor(config?: Partial<EnkaAssetConfig>);
+    /**
+     * Get data from cache if valid
+     */
+    get<T>(key: string): T | null;
+    /**
+     * Set data in cache
+     */
+    set<T>(key: string, data: T, ttl?: number): void;
+    /**
+     * Get player data cache key
+     */
+    getPlayerCacheKey(uid: string | number): string;
+    /**
+     * Check if player data is cached and valid
+     */
+    hasValidPlayerCache(uid: string | number): boolean;
+    /**
+     * Get cached player data
+     */
+    getCachedPlayerData<T>(uid: string | number): T | null;
+    /**
+     * Cache player data
+     */
+    cachePlayerData<T>(uid: string | number, data: T): void;
+    /**
+     * Clear specific cache entry
+     */
+    invalidate(key: string): boolean;
+    /**
+     * Clear player cache
+     */
+    invalidatePlayer(uid: string | number): boolean;
+    /**
+     * Clear all cache
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        total: number;
+        valid: number;
+        expired: number;
+    };
+    /**
+     * Cleanup expired entries
+     */
+    cleanup(): number;
+    /**
+     * Get cache entry info
+     */
+    getCacheInfo(key: string): {
+        exists: boolean;
+        valid?: boolean;
+        age?: number;
+        ttl?: number;
+    };
+}
+//# sourceMappingURL=cache-manager.d.ts.map