@lycoristech/azurdata 0.0.1

package/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 korone
+
+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.
+
+NOTE: This license applies to the code only. Game data extracted from
+Azur Lane is the property of Yostar/Manjuu/Yongshi. This project is not
+affiliated with or endorsed by these companies.

package/README.md

@@ -0,0 +1,123 @@
+# AzurAPI
+
+A self-maintained, current Azur Lane data library. Drop-in replacement for the abandoned `@azurapi/azurapi` package.
+
+## Why?
+
+The old `@azurapi/azurapi` ecosystem died in early 2023 — its wiki-scraper broke and nobody fixed it. Ship data is now 3+ years stale. AzurAPI builds on [AzurLaneTools/AzurLaneData](https://github.com/AzurLaneTools/AzurLaneData), an automatically-updating mirror of the game's raw JSON files, so our data stays fresh within hours of each game patch.
+
+## Installation
+
+```bash
+# From GitHub (recommended until npm publish)
+npm install github:iujab/AzurAPI
+
+# Or from npm (when published)
+npm install azurdata
+```
+
+## Usage
+
+```ts
+import { AzurData } from "azurdata";
+
+const azur = new AzurData();
+
+// Get a ship by name, ID, or fuzzy search
+const belfast = azur.ships.get("Belfast");
+const byId    = azur.ships.get("20212");       // canonical group_type
+const byCode  = azur.ships.get("115");          // legacy AzurAPI 3-digit code
+
+// Get all ships
+const all = azur.ships.getAll();                 // Ship[]
+console.log(`${azur.ships.count()} ships loaded`);
+
+// Fuzzy search
+const results = azur.ships.search("Enterp", 5); // top 5 matches
+```
+
+## Migrating from @azurapi/azurapi
+
+```diff
+- import { AzurAPI } from "@azurapi/azurapi";
++ import { AzurData as AzurAPI } from "azurdata";
+```
+
+That's it. The `ships.get()` API is compatible. Ship objects match the same schema, including field names like `antiwar` (AA) for backwards compat.
+
+## Data Freshness
+
+Data is auto-refreshed weekly (every Monday) via GitHub Actions from [AzurLaneTools/AzurLaneData](https://github.com/AzurLaneTools/AzurLaneData) (EN + CN + JP regions). The refresh pipeline:
+1. Sparse-clones the upstream repo
+2. Normalizes raw game tables into AzurAPI-compatible JSON
+3. Runs sanity checks (schema validation, field coverage)
+4. Commits updated `data/*.json` only if data changed
+
+You can also trigger a refresh manually from the Actions tab, or run `npm run build:data` locally.
+
+Current data version: see [`data/version.json`](data/version.json).
+
+## Ship Schema
+
+Ships have the full AzurAPI-compatible shape including:
+- Identity: `id`, `names`, `rarity`, `class`, `hullType`, `nationality`
+- Stats: level 100/120, with and without retrofit
+- Equipment slots with min/max efficiency
+- Skills with max-rank substituted descriptions
+- Limit breaks, construction info, fleet tech
+- Skins with metadata
+- And more — see [`src/schema/output/ship.ts`](src/schema/output/ship.ts)
+
+## Raw JSON Access
+
+The committed `data/ships.json` is fetchable via GitHub raw URL:
+
+```
+https://raw.githubusercontent.com/iujab/AzurAPI/main/data/ships.json
+```
+
+Also available: `ship-list.json` (minimal index), `id-map.json` (name→id lookup), `version.json`.
+
+## Development
+
+```bash
+# Install deps
+npm install
+
+# Build data from upstream (requires upstream/ sparse checkout)
+npm run build:data
+
+# Verify data integrity
+npm run verify
+
+# Run tests
+npm test
+
+# Type check
+npm run typecheck
+```
+
+## Architecture
+
+```
+upstream/azurlane-data/  →  src/ingest/  →  src/schema/raw/  →  src/normalize/  →  src/output/  →  data/*.json
+                                                                                                        ↓
+                                                                                               src/client/  →  consumers
+```
+
+## Asset Images
+
+Ship paintings and thumbnails are hosted in a separate GitHub repo: [iujab/azurlane-images](https://github.com/iujab/azurlane-images). Image URLs in ship data point to raw GitHub URLs from that repo:
+
+- **Paintings** — skin art in WebP format (`paintings/{asset_name}.webp`)
+- **Thumbnails** — shipyard icons in PNG format (`thumbnails/{group_type}.png`)
+
+## License
+
+MIT for the code. Game data is extracted from publicly available game files and is the property of Yostar/Manjuu/Yongshi. This project is not affiliated with or endorsed by any of these companies.
+
+## Acknowledgments
+
+- [AzurLaneTools/AzurLaneData](https://github.com/AzurLaneTools/AzurLaneData) — upstream auto-updating game data
+- [nobbyfix/AzurLane-AssetDownloader](https://github.com/nobbyfix/AzurLane-AssetDownloader) — game asset extraction
+- [AzurAPI/azurapi-js](https://github.com/AzurAPI/azurapi-js) — the original library whose schema we replicate