pogo-masterfile 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## [Unreleased]
+
+- Initial release: `Masterfile` class with `fromRemote`/`fromJson`, literal-typed `getEntry`/`tryGetEntry`/`has`/`getGroup`, per-group accessor surface, search/iteration/refresh primitives.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hazel's Lab Contributors
+
+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,187 @@
+# pogo-masterfile
+
+Runtime API for the Pokémon GO masterfile. Loads, indexes, and queries entries with per-group literal-typed accessors. Built on [`pogo-masterfile-types`](../ts/README.md).
+
+## Install
+
+```bash
+npm install pogo-masterfile
+# or
+bun add pogo-masterfile
+```
+
+## Quickstart
+
+```ts
+import { Masterfile } from "pogo-masterfile";
+
+const mf = await Masterfile.fromRemote();
+
+// Top-level lookup — wide return type (MasterfileEntry).
+const move = mf.getEntry("V0022_MOVE_MEGAHORN");
+
+// Per-group accessor — literal-narrow return type, full intellisense.
+// `tackle` is typed as the exact literal entry, e.g. its `power` is `105`.
+const tackle = mf.moveSettings.get("V0033_MOVE_TACKLE_FAST");
+
+// Iterate one group.
+for (const m of mf.moveSettings) {
+  // m is fully typed as a MoveSettingsMasterfileEntry
+}
+
+// Search.
+const items = mf.findByPattern(/^ITEM_/);
+```
+
+### Top-level vs per-group lookups
+
+The `Masterfile` class deliberately splits its lookup APIs to keep TypeScript's
+compile times fast:
+
+- **Top-level** (`mf.getEntry`, `mf.tryGetEntry`, `mf.has`) returns the wide
+  `MasterfileEntry` union with no literal narrowing. Use it when you have an
+  arbitrary string templateId and just want the entry.
+- **Per-group accessor** (`mf.moveSettings.get`, etc.) narrows to the exact
+  literal entry type for that group's templateIds. Use it when you know the
+  group up front — you get full autocomplete on IDs and a precisely-typed
+  return value.
+
+If you want cross-group literal narrowing on top-level lookups, import the
+explicit `EntryByTemplateID` interface from `pogo-masterfile-types/lookup-table`
+and cast to it. That interface materializes ~18k keys and is correspondingly
+expensive to type-check, so reach for it only when you actually need it.
+
+## Loading
+
+`Masterfile` instances are constructed via two factories:
+
+```ts
+// Fetch from the default community mirror (alexelgt/game_masters).
+const mf = await Masterfile.fromRemote();
+
+// Wrap an already-loaded array (e.g., bundled with your app or fetched manually).
+const mf = Masterfile.fromJson(myEntries);
+```
+
+### Custom URL
+
+```ts
+const mf = await Masterfile.fromRemote({
+  url: "https://my-cdn.example/masterfile.json",
+});
+```
+
+### Custom fetcher
+
+If your upstream returns a different shape, supply a custom fetcher that normalizes to `MasterfileEntry[]`:
+
+```ts
+const mf = await Masterfile.fromRemote({
+  fetcher: async (url, signal) => {
+    const r = await fetch(url, {
+      signal,
+      headers: { Authorization: `Bearer ${token}` },
+    });
+    const wrapped = (await r.json()) as { data: MasterfileEntry[] };
+    return wrapped.data;
+  },
+});
+```
+
+You can also compose around the default fetcher:
+
+```ts
+import { defaultFetcher } from "pogo-masterfile/fetch";
+
+const mf = await Masterfile.fromRemote({
+  fetcher: async (url, signal) => {
+    const entries = await defaultFetcher(url, signal);
+    return entries.filter((e) => /* user filter */);
+  },
+});
+```
+
+### Cancellation
+
+```ts
+const ac = new AbortController();
+setTimeout(() => ac.abort(), 5000);
+const mf = await Masterfile.fromRemote({ signal: ac.signal });
+```
+
+## Top-level API
+
+| Method | Description |
+|---|---|
+| `getEntry(id)` | Return the entry (wide `MasterfileEntry`). Throws `EntryNotFoundError` if missing. |
+| `tryGetEntry(id)` | Return the entry or `undefined`. |
+| `has(id)` | Boolean check. |
+| `getAll()` | All entries. |
+| `getGroup(name)` | All entries for one group, narrowed to that group's union. |
+| `groups()` | All group names. |
+| `templateIds()` / `templateIds(group)` | All template IDs (or just one group's). |
+| `[Symbol.iterator]()` | `for (const e of mf)` over all entries. |
+| `size` | Total entry count. |
+| `raw` | Underlying `MasterfileEntry[]` (read-only view). |
+| `find(pred)` / `filter(pred)` | Predicate search over all entries. |
+| `findByPattern(regex)` | All entries whose `templateId` matches the regex. |
+| `refresh(opts?)` | Re-fetch from remote and swap data atomically. |
+| `update(json)` | Replace data with a provided array (sync). |
+
+## Per-group accessors
+
+For every group `G`, `mf.<G>` is a `GroupAccessor<G>` with a focused, narrowly-typed mini-API:
+
+```ts
+mf.moveSettings.get(id)            // throws if missing
+mf.moveSettings.tryGet(id)         // T | undefined
+mf.moveSettings.has(id)            // type predicate
+mf.moveSettings.all()              // alias for getGroup("moveSettings")
+mf.moveSettings.templateIds()      // narrow ID array
+mf.moveSettings.find(predicate)    // predicate typed against MoveSettings union
+mf.moveSettings.filter(predicate)
+mf.moveSettings.size
+for (const m of mf.moveSettings) { … }
+```
+
+The accessor's `find` / `filter` predicates receive the narrow group union, so `entry.data.moveSettings` autocompletes without runtime type guards.
+
+## Errors
+
+```ts
+import { MasterfileFetchError, MasterfileParseError, EntryNotFoundError } from "pogo-masterfile/errors";
+
+try {
+  const mf = await Masterfile.fromRemote();
+} catch (err) {
+  if (err instanceof MasterfileFetchError) console.error("fetch failed:", err.url, err.cause);
+  if (err instanceof MasterfileParseError) console.error("parse failed:", err.cause);
+}
+
+try {
+  mf.getEntry("DOES_NOT_EXIST");
+} catch (err) {
+  if (err instanceof EntryNotFoundError) console.error("missing:", err.templateId);
+}
+```
+
+## Module resolution
+
+This package ships compiled `.js` + `.d.ts` from a `src/` → `dist/` build. It targets `module: "ES2022"` and uses universal `fetch` (Node ≥18, modern browsers, Bun, Deno). No polyfills needed.
+
+```jsonc
+// tsconfig.json
+{
+  "compilerOptions": {
+    "moduleResolution": "bundler" // or "node16" / "nodenext"
+  }
+}
+```
+
+## Source
+
+All code under `dist/` is built from generated source in `src/`, which is itself produced by the codegen pipeline at the [repo root](https://github.com/Hazels-Lab/pogo-masterfile). Don't edit emitted files by hand — re-run `bun run generate`.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/errors.d.ts

@@ -0,0 +1,17 @@
+/** Network or HTTP failure when fetching the masterfile. */
+export declare class MasterfileFetchError extends Error {
+    readonly url: string;
+    readonly cause?: unknown;
+    constructor(message: string, url: string, cause?: unknown);
+}
+/** Response could not be parsed as a `MasterfileEntry[]`. */
+export declare class MasterfileParseError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/** A `getEntry` lookup did not find an entry with the given templateId. */
+export declare class EntryNotFoundError extends Error {
+    readonly templateId: string;
+    constructor(templateId: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAMzD;AAED,6DAA6D;AAC7D,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,SAAkB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK5C;AAED,2EAA2E;AAC3E,qBAAa,kBAAmB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM;CAK9B"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+/** Network or HTTP failure when fetching the masterfile. */
+export class MasterfileFetchError extends Error {
+    url;
+    cause;
+    constructor(message, url, cause) {
+        super(message);
+        this.name = "MasterfileFetchError";
+        this.url = url;
+        this.cause = cause;
+    }
+}
+/** Response could not be parsed as a `MasterfileEntry[]`. */
+export class MasterfileParseError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.name = "MasterfileParseError";
+        this.cause = cause;
+    }
+}
+/** A `getEntry` lookup did not find an entry with the given templateId. */
+export class EntryNotFoundError extends Error {
+    templateId;
+    constructor(templateId) {
+        super(`No entry with templateId "${templateId}"`);
+        this.name = "EntryNotFoundError";
+        this.templateId = templateId;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACrC,GAAG,CAAS;IACH,KAAK,CAAW;IAElC,YAAY,OAAe,EAAE,GAAW,EAAE,KAAe;QACxD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;CACD;AAED,6DAA6D;AAC7D,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC5B,KAAK,CAAW;IAElC,YAAY,OAAe,EAAE,KAAe;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;CACD;AAED,2EAA2E;AAC3E,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IACnC,UAAU,CAAS;IAE5B,YAAY,UAAkB;QAC7B,KAAK,CAAC,6BAA6B,UAAU,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;CACD"}

package/dist/fetch.d.ts

@@ -0,0 +1,9 @@
+import type { Fetcher } from "./types";
+export declare const DEFAULT_MASTERFILE_URL = "https://raw.githubusercontent.com/alexelgt/game_masters/refs/heads/master/GAME_MASTER.json";
+/**
+ * Default fetcher: standard `fetch` + JSON parse, with shape validation.
+ * Throws `MasterfileFetchError` for network/HTTP failures and
+ * `MasterfileParseError` for invalid JSON or non-array bodies.
+ */
+export declare const defaultFetcher: Fetcher;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,eAAO,MAAM,sBAAsB,+FAA+F,CAAC;AAEnI;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,OAoB5B,CAAC"}

package/dist/fetch.js

@@ -0,0 +1,31 @@
+import { MasterfileFetchError, MasterfileParseError } from "./errors";
+export const DEFAULT_MASTERFILE_URL = "https://raw.githubusercontent.com/alexelgt/game_masters/refs/heads/master/GAME_MASTER.json";
+/**
+ * Default fetcher: standard `fetch` + JSON parse, with shape validation.
+ * Throws `MasterfileFetchError` for network/HTTP failures and
+ * `MasterfileParseError` for invalid JSON or non-array bodies.
+ */
+export const defaultFetcher = async (url, signal) => {
+    let response;
+    try {
+        response = await fetch(url, { signal });
+    }
+    catch (cause) {
+        throw new MasterfileFetchError(`network error fetching ${url}`, url, cause);
+    }
+    if (!response.ok) {
+        throw new MasterfileFetchError(`${response.status} ${response.statusText} from ${url}`, url);
+    }
+    let json;
+    try {
+        json = await response.json();
+    }
+    catch (cause) {
+        throw new MasterfileParseError("response body is not valid JSON", cause);
+    }
+    if (!Array.isArray(json)) {
+        throw new MasterfileParseError("expected top-level JSON array of entries");
+    }
+    return json;
+};
+//# sourceMappingURL=fetch.js.map

package/dist/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGtE,MAAM,CAAC,MAAM,sBAAsB,GAAG,4FAA4F,CAAC;AAEnI;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAY,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;IAC5D,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACJ,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,oBAAoB,CAAC,0BAA0B,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QAClB,MAAM,IAAI,oBAAoB,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,SAAS,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACJ,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,oBAAoB,CAAC,iCAAiC,EAAE,KAAK,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,oBAAoB,CAAC,0CAA0C,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,IAAyB,CAAC;AAClC,CAAC,CAAC"}

package/dist/group-names.d.ts

@@ -0,0 +1,3 @@
+export declare const GROUP_NAMES: readonly ["avatarCustomization", "avatarGroupOrderSettings", "avatarItemDisplay", "badgeSettings", "breadMoveLevelSettings", "buddyActivityCategorySettings", "buddyEmotionLevelSettings", "buddyLevelSettings", "clientQuestTemplate", "codeGateProto", "combatLeague", "combatMove", "combatNpcPersonality", "combatNpcTrainer", "combatRankingProtoSettings", "combatType", "eventPassSettings", "eventPassTierSettings", "evolutionChainDisplaySettings", "evolutionQuestTemplate", "featureGate", "formSettings", "fortPowerUpLevelSettings", "friendshipMilestoneSettings", "genderSettings", "iapCategoryDisplay", "iapItemDisplay", "invasionNpcDisplaySettings", "itemExpirationSettings", "itemSettings", "languageSettings", "levelUpRewards", "limitedPurchaseSkuSettings", "locationCardSettings", "megaEvoLevelSettings", "moveSequenceSettings", "moveSettings", "nonCombatMoveSettings", "partyPlayGeneralSettings", "photoSetsSettingsProto", "pokemonExtendedSettings", "pokemonFamily", "pokemonHomeEnergyCosts", "pokemonHomeFormReversions", "pokemonScaleSettings", "pokemonSettings", "pokemonUpgrades", "pokestopInvasionAvailabilitySettings", "questSettings", "recommendedSearchSettings", "rollBack", "settingsOverrideRule", "singletons", "stickerMetadata", "tappableSettings", "temporaryEvolutionSettings", "typeEffective", "vsSeekerLoot", "vsSeekerPokemonRewards", "weatherAffinities"];
+export type GroupName = (typeof GROUP_NAMES)[number];
+//# sourceMappingURL=group-names.d.ts.map

package/dist/group-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-names.d.ts","sourceRoot":"","sources":["../src/group-names.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,81CA6Dd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/group-names.js

@@ -0,0 +1,64 @@
+// Generated from Pokémon GO masterfile — list of group discriminators.
+export const GROUP_NAMES = [
+    "avatarCustomization",
+    "avatarGroupOrderSettings",
+    "avatarItemDisplay",
+    "badgeSettings",
+    "breadMoveLevelSettings",
+    "buddyActivityCategorySettings",
+    "buddyEmotionLevelSettings",
+    "buddyLevelSettings",
+    "clientQuestTemplate",
+    "codeGateProto",
+    "combatLeague",
+    "combatMove",
+    "combatNpcPersonality",
+    "combatNpcTrainer",
+    "combatRankingProtoSettings",
+    "combatType",
+    "eventPassSettings",
+    "eventPassTierSettings",
+    "evolutionChainDisplaySettings",
+    "evolutionQuestTemplate",
+    "featureGate",
+    "formSettings",
+    "fortPowerUpLevelSettings",
+    "friendshipMilestoneSettings",
+    "genderSettings",
+    "iapCategoryDisplay",
+    "iapItemDisplay",
+    "invasionNpcDisplaySettings",
+    "itemExpirationSettings",
+    "itemSettings",
+    "languageSettings",
+    "levelUpRewards",
+    "limitedPurchaseSkuSettings",
+    "locationCardSettings",
+    "megaEvoLevelSettings",
+    "moveSequenceSettings",
+    "moveSettings",
+    "nonCombatMoveSettings",
+    "partyPlayGeneralSettings",
+    "photoSetsSettingsProto",
+    "pokemonExtendedSettings",
+    "pokemonFamily",
+    "pokemonHomeEnergyCosts",
+    "pokemonHomeFormReversions",
+    "pokemonScaleSettings",
+    "pokemonSettings",
+    "pokemonUpgrades",
+    "pokestopInvasionAvailabilitySettings",
+    "questSettings",
+    "recommendedSearchSettings",
+    "rollBack",
+    "settingsOverrideRule",
+    "singletons",
+    "stickerMetadata",
+    "tappableSettings",
+    "temporaryEvolutionSettings",
+    "typeEffective",
+    "vsSeekerLoot",
+    "vsSeekerPokemonRewards",
+    "weatherAffinities",
+];
+//# sourceMappingURL=group-names.js.map

package/dist/group-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-names.js","sourceRoot":"","sources":["../src/group-names.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,qBAAqB;IACrB,0BAA0B;IAC1B,mBAAmB;IACnB,eAAe;IACf,wBAAwB;IACxB,+BAA+B;IAC/B,2BAA2B;IAC3B,oBAAoB;IACpB,qBAAqB;IACrB,eAAe;IACf,cAAc;IACd,YAAY;IACZ,sBAAsB;IACtB,kBAAkB;IAClB,4BAA4B;IAC5B,YAAY;IACZ,mBAAmB;IACnB,uBAAuB;IACvB,+BAA+B;IAC/B,wBAAwB;IACxB,aAAa;IACb,cAAc;IACd,0BAA0B;IAC1B,6BAA6B;IAC7B,gBAAgB;IAChB,oBAAoB;IACpB,gBAAgB;IAChB,4BAA4B;IAC5B,wBAAwB;IACxB,cAAc;IACd,kBAAkB;IAClB,gBAAgB;IAChB,4BAA4B;IAC5B,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,cAAc;IACd,uBAAuB;IACvB,0BAA0B;IAC1B,wBAAwB;IACxB,yBAAyB;IACzB,eAAe;IACf,wBAAwB;IACxB,2BAA2B;IAC3B,sBAAsB;IACtB,iBAAiB;IACjB,iBAAiB;IACjB,sCAAsC;IACtC,eAAe;IACf,2BAA2B;IAC3B,UAAU;IACV,sBAAsB;IACtB,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,4BAA4B;IAC5B,eAAe;IACf,cAAc;IACd,wBAAwB;IACxB,mBAAmB;CACV,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { EntryNotFoundError, MasterfileFetchError, MasterfileParseError } from "./errors";
+export { DEFAULT_MASTERFILE_URL, defaultFetcher } from "./fetch";
+export type { GroupAccessor } from "./masterfile";
+export { Masterfile } from "./masterfile";
+export type { Fetcher, FromRemoteOptions } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Generated from Pokémon GO masterfile — top-level barrel.
+export { EntryNotFoundError, MasterfileFetchError, MasterfileParseError } from "./errors";
+export { DEFAULT_MASTERFILE_URL, defaultFetcher } from "./fetch";
+export { Masterfile } from "./masterfile";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAE3D,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAC1F,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/masterfile.d.ts

@@ -0,0 +1,47 @@
+/** biome-ignore-all lint/suspicious/noUnsafeDeclarationMerging: the Masterfile class+interface merge below intentionally adds per-group accessor properties installed dynamically in the constructor. */
+import type { MasterfileEntry } from "pogo-masterfile-types/entries";
+import type { EntriesByGroup, LookupByGroup, TemplateIDsByGroup } from "pogo-masterfile-types/lookup-table";
+import { type GroupName } from "./group-names";
+import type { FromRemoteOptions } from "./types";
+export interface GroupAccessor<G extends GroupName> {
+    get<T extends keyof LookupByGroup[G] & string>(templateId: T): LookupByGroup[G][T];
+    get(templateId: string): EntriesByGroup[G];
+    tryGet<T extends keyof LookupByGroup[G] & string>(templateId: T): LookupByGroup[G][T] | undefined;
+    tryGet(templateId: string): EntriesByGroup[G] | undefined;
+    has(templateId: string): templateId is keyof LookupByGroup[G] & string;
+    all(): readonly EntriesByGroup[G][];
+    templateIds(): readonly (TemplateIDsByGroup[G] & string)[];
+    find(predicate: (entry: EntriesByGroup[G]) => boolean): EntriesByGroup[G] | undefined;
+    filter(predicate: (entry: EntriesByGroup[G]) => boolean): readonly EntriesByGroup[G][];
+    readonly size: number;
+    [Symbol.iterator](): IterableIterator<EntriesByGroup[G]>;
+}
+type GroupAccessorMap = {
+    [G in GroupName]: GroupAccessor<G>;
+};
+export declare class Masterfile {
+    #private;
+    private constructor();
+    static fromRemote(opts?: FromRemoteOptions): Promise<Masterfile>;
+    static fromJson(json: readonly MasterfileEntry[]): Masterfile;
+    getEntry(templateId: string): MasterfileEntry;
+    tryGetEntry(templateId: string): MasterfileEntry | undefined;
+    has(templateId: string): boolean;
+    getAll(): readonly MasterfileEntry[];
+    getGroup<G extends GroupName>(group: G): readonly EntriesByGroup[G][];
+    groups(): readonly GroupName[];
+    templateIds(): readonly string[];
+    templateIds<G extends GroupName>(group: G): readonly (TemplateIDsByGroup[G] & string)[];
+    [Symbol.iterator](): IterableIterator<MasterfileEntry>;
+    get size(): number;
+    get raw(): readonly MasterfileEntry[];
+    refresh(opts?: FromRemoteOptions): Promise<void>;
+    update(json: readonly MasterfileEntry[]): void;
+    find(predicate: (entry: MasterfileEntry) => boolean): MasterfileEntry | undefined;
+    filter(predicate: (entry: MasterfileEntry) => boolean): readonly MasterfileEntry[];
+    findByPattern(pattern: RegExp): readonly MasterfileEntry[];
+}
+export interface Masterfile extends GroupAccessorMap {
+}
+export {};
+//# sourceMappingURL=masterfile.d.ts.map

package/dist/masterfile.d.ts.map

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

package/dist/masterfile.js

@@ -0,0 +1,163 @@
+/** biome-ignore-all lint/suspicious/noUnsafeDeclarationMerging: the Masterfile class+interface merge below intentionally adds per-group accessor properties installed dynamically in the constructor. */
+import { EntryNotFoundError } from "./errors";
+import { DEFAULT_MASTERFILE_URL, defaultFetcher } from "./fetch";
+import { GROUP_NAMES } from "./group-names";
+// ── Class ──────────────────────────────────────────────────────────────────
+export class Masterfile {
+    #entries = [];
+    #byTemplateId = new Map();
+    #byGroup = new Map();
+    constructor(entries) {
+        this.#install(entries);
+        for (const groupName of GROUP_NAMES) {
+            this.#installAccessor(groupName);
+        }
+    }
+    // ── Loaders ──
+    static async fromRemote(opts = {}) {
+        const url = opts.url ?? DEFAULT_MASTERFILE_URL;
+        const fetcher = opts.fetcher ?? defaultFetcher;
+        const entries = await fetcher(url, opts.signal);
+        return new Masterfile(entries);
+    }
+    static fromJson(json) {
+        return new Masterfile(json);
+    }
+    // ── Core lookups ──
+    //
+    // Top-level lookups return the wide `MasterfileEntry` union — no literal
+    // narrowing. For literal narrowing, reach for the per-group accessor:
+    // `mf.moveSettings.get("V0022_MOVE_MEGAHORN")` returns the exact literal
+    // entry type. (Cross-group literal narrowing requires materializing the
+    // global `EntryByTemplateID` interface from
+    // `pogo-masterfile-types/lookup-table`, which is genuinely expensive.)
+    getEntry(templateId) {
+        const entry = this.#byTemplateId.get(templateId);
+        if (!entry)
+            throw new EntryNotFoundError(templateId);
+        return entry;
+    }
+    tryGetEntry(templateId) {
+        return this.#byTemplateId.get(templateId);
+    }
+    has(templateId) {
+        return this.#byTemplateId.has(templateId);
+    }
+    getAll() {
+        return this.#entries;
+    }
+    getGroup(group) {
+        return (this.#byGroup.get(group) ?? []);
+    }
+    // ── Introspection ──
+    groups() {
+        return GROUP_NAMES;
+    }
+    templateIds(group) {
+        if (group === undefined) {
+            return [...this.#byTemplateId.keys()];
+        }
+        return (this.#byGroup.get(group) ?? []).map((e) => e.templateId);
+    }
+    [Symbol.iterator]() {
+        return this.#entries[Symbol.iterator]();
+    }
+    get size() {
+        return this.#entries.length;
+    }
+    get raw() {
+        return this.#entries;
+    }
+    // ── Mutation ──
+    async refresh(opts = {}) {
+        const url = opts.url ?? DEFAULT_MASTERFILE_URL;
+        const fetcher = opts.fetcher ?? defaultFetcher;
+        const entries = await fetcher(url, opts.signal);
+        this.#install(entries);
+    }
+    update(json) {
+        this.#install(json);
+    }
+    // ── Top-level search ──
+    find(predicate) {
+        return this.#entries.find(predicate);
+    }
+    filter(predicate) {
+        return this.#entries.filter(predicate);
+    }
+    findByPattern(pattern) {
+        return this.#entries.filter((e) => pattern.test(e.templateId));
+    }
+    // ── Internals ──
+    #install(entries) {
+        const byTemplateId = new Map();
+        const byGroup = new Map();
+        for (const groupName of GROUP_NAMES) {
+            byGroup.set(groupName, []);
+        }
+        for (const entry of entries) {
+            byTemplateId.set(entry.templateId, entry);
+            const group = detectGroup(entry);
+            if (group !== undefined) {
+                byGroup.get(group).push(entry);
+            }
+            else {
+                const singletonsKey = "singletons";
+                const list = byGroup.get(singletonsKey);
+                if (list)
+                    list.push(entry);
+            }
+        }
+        this.#entries = entries;
+        this.#byTemplateId = byTemplateId;
+        this.#byGroup = byGroup;
+    }
+    #installAccessor(groupName) {
+        const self = this;
+        const accessor = {
+            get(templateId) {
+                const entry = self.#byTemplateId.get(templateId);
+                if (!entry)
+                    throw new EntryNotFoundError(templateId);
+                return entry;
+            },
+            tryGet(templateId) {
+                return self.#byTemplateId.get(templateId);
+            },
+            has(templateId) {
+                const list = self.#byGroup.get(groupName) ?? [];
+                return list.some((e) => e.templateId === templateId);
+            },
+            all() {
+                return (self.#byGroup.get(groupName) ?? []);
+            },
+            templateIds() {
+                return (self.#byGroup.get(groupName) ?? []).map((e) => e.templateId);
+            },
+            find(predicate) {
+                return (self.#byGroup.get(groupName) ?? []).find(predicate);
+            },
+            filter(predicate) {
+                return (self.#byGroup.get(groupName) ?? []).filter(predicate);
+            },
+            get size() {
+                return (self.#byGroup.get(groupName) ?? []).length;
+            },
+            [Symbol.iterator]() {
+                return (self.#byGroup.get(groupName) ?? [])[Symbol.iterator]();
+            },
+        };
+        this[groupName] = accessor;
+    }
+}
+function detectGroup(entry) {
+    const dataKeys = Object.keys(entry.data).filter((k) => k !== "templateId");
+    const first = dataKeys[0];
+    if (first === undefined)
+        return undefined;
+    if (GROUP_NAMES.includes(first)) {
+        return first;
+    }
+    return undefined;
+}
+//# sourceMappingURL=masterfile.js.map

package/dist/masterfile.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+import type { MasterfileEntry } from "pogo-masterfile-types/entries";
+export interface FromRemoteOptions {
+    /** URL to fetch from. Defaults to `DEFAULT_MASTERFILE_URL`. */
+    url?: string;
+    /** Custom fetcher. Default uses global `fetch` + `response.json()`. */
+    fetcher?: Fetcher;
+    /** Cancellation. */
+    signal?: AbortSignal;
+}
+/**
+ * Fetch the masterfile JSON and normalize it to `MasterfileEntry[]`.
+ *
+ * Custom fetchers MUST handle whatever upstream shape they receive and return
+ * an array conforming to `MasterfileEntry[]`. They should propagate `signal`
+ * to the underlying fetch so cancellation works.
+ */
+export type Fetcher = (url: string, signal?: AbortSignal) => Promise<MasterfileEntry[]>;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,WAAW,iBAAiB;IACjC,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,66 @@
+{
+	"name": "pogo-masterfile",
+	"version": "0.1.0",
+	"description": "Runtime API for the Pokémon GO masterfile. Loads, indexes, and queries entries with literal-typed lookups and per-group accessors. Built on `pogo-masterfile-types`.",
+	"license": "MIT",
+	"author": "Hazel's Lab (https://github.com/Hazels-Lab)",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Hazels-Lab/pogo-masterfile.git",
+		"directory": "packages/ts-api"
+	},
+	"homepage": "https://github.com/Hazels-Lab/pogo-masterfile#readme",
+	"bugs": {
+		"url": "https://github.com/Hazels-Lab/pogo-masterfile/issues"
+	},
+	"keywords": [
+		"pokemon-go",
+		"pokemon",
+		"masterfile",
+		"api",
+		"typescript"
+	],
+	"type": "module",
+	"sideEffects": false,
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		},
+		"./fetch": {
+			"import": "./dist/fetch.js",
+			"types": "./dist/fetch.d.ts"
+		},
+		"./errors": {
+			"import": "./dist/errors.js",
+			"types": "./dist/errors.d.ts"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE",
+		"CHANGELOG.md"
+	],
+	"publishConfig": {
+		"access": "public"
+	},
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"check": "tsc --noEmit -p tsconfig.json",
+		"prepublishOnly": "bun run build"
+	},
+	"dependencies": {
+		"pogo-masterfile-types": "workspace:^"
+	},
+	"peerDependencies": {
+		"typescript": ">=5.0"
+	},
+	"peerDependenciesMeta": {
+		"typescript": {
+			"optional": true
+		}
+	}
+}