@omnigateway/pokemon 1.1.1 → 1.2.2

package/server/index.js

@@ -86,909 +86,1094 @@ function hasAnimatedSprite(speciesId) {
   return speciesId >= 1 && speciesId <= ANIMATED_SPECIES_MAX;
 }
 
-// node_modules/@omnigateway/plugin-api/src/events.ts
-var WINDOW_MS = {
-  "1m": 60000,
-  "5h": 5 * 60 * 60 * 1000,
-  "1w": 7 * 24 * 60 * 60 * 1000
-};
-
-// src/grants.ts
-function windowKey(event) {
-  return `${event.dimension}:${event.window}`;
-}
-function grantSize(window) {
-  if (window === "1w")
-    return 5;
-  if (window === "5h")
-    return 1;
-  return 0;
+// src/advance.ts
+var MAX_TRANSITIONS_PER_ADVANCE = 64;
+function advance(state, tokensTotal, now) {
+  const gained = Math.max(0, Math.trunc(tokensTotal) - state.consumedTotal);
+  const events = [];
+  let next = { ...state, consumedTotal: Math.trunc(tokensTotal) };
+  if (gained > 0) {
+    const active = next.active;
+    if (active === null) {
+      next = { ...next, eggUsage: next.eggUsage + gained };
+    } else if (!active.soothe) {
+      next = { ...next, active: { ...active, usedAtStage: active.usedAtStage + gained } };
+    } else {
+      const raw = active.soothedRaw + gained;
+      const owed = Math.floor(raw * SOOTHE_BONUS) - Math.floor(active.soothedRaw * SOOTHE_BONUS);
+      next = {
+        ...next,
+        active: { ...active, soothedRaw: raw, usedAtStage: active.usedAtStage + gained + owed }
+      };
+    }
+  }
+  for (let step = 0;step < MAX_TRANSITIONS_PER_ADVANCE; step++) {
+    if (next.active === null) {
+      if (next.eggUsage < EGG_HATCH_THRESHOLD)
+        break;
+      if (next.pendingHatch === null)
+        break;
+      const hatch = next.pendingHatch;
+      const active = {
+        baseId: hatch.path[0] ?? hatch.speciesId,
+        plannedPath: hatch.path,
+        stageIndex: 0,
+        stageTimes: [now],
+        usedAtStage: next.eggUsage - EGG_HATCH_THRESHOLD,
+        rarity: hatch.rarity,
+        isShiny: hatch.isShiny,
+        nature: hatch.nature,
+        dittoDisguise: hatch.ditto ? hatch.speciesId : null,
+        dittoRevealed: false,
+        everstone: false,
+        soothe: false,
+        soothedRaw: 0
+      };
+      events.push({
+        kind: "hatched",
+        speciesId: hatch.speciesId,
+        isShiny: active.isShiny,
+        ditto: active.dittoDisguise !== null
+      });
+      next = { ...next, active, eggUsage: 0, eggTier: null, pendingHatch: null };
+      continue;
+    }
+    const mon = next.active;
+    if (mon.everstone)
+      break;
+    const needed = phaseThreshold(mon.rarity, mon.plannedPath.length, mon.stageIndex);
+    if (mon.usedAtStage < needed)
+      break;
+    const excess = mon.usedAtStage - needed;
+    if (mon.dittoDisguise !== null && !mon.dittoRevealed) {
+      if (next.pendingReveal === null)
+        break;
+      const reveal = next.pendingReveal;
+      events.push({
+        kind: "revealed",
+        disguisedAs: mon.plannedPath[mon.stageIndex] ?? mon.baseId,
+        speciesId: reveal.path[0]
+      });
+      next = {
+        ...next,
+        active: {
+          ...mon,
+          baseId: reveal.path[0],
+          plannedPath: reveal.path,
+          stageIndex: 0,
+          stageTimes: [now],
+          usedAtStage: excess,
+          rarity: reveal.rarity,
+          dittoRevealed: true
+        },
+        pendingReveal: null
+      };
+      continue;
+    }
+    if (mon.stageIndex < mon.plannedPath.length - 1) {
+      events.push({
+        kind: "evolved",
+        from: mon.plannedPath[mon.stageIndex],
+        to: mon.plannedPath[mon.stageIndex + 1]
+      });
+      next = {
+        ...next,
+        active: {
+          ...mon,
+          stageIndex: mon.stageIndex + 1,
+          usedAtStage: excess,
+          stageTimes: stampedAt(mon.stageTimes, mon.stageIndex + 1, now)
+        }
+      };
+      continue;
+    }
+    events.push({
+      kind: "graduated",
+      baseId: mon.baseId,
+      finalId: mon.plannedPath[mon.plannedPath.length - 1],
+      chainOrder: mon.plannedPath,
+      stageTimes: stampedAt(mon.stageTimes, mon.plannedPath.length - 1, now),
+      rarity: mon.rarity,
+      isShiny: mon.isShiny,
+      nature: mon.nature
+    });
+    next = { ...next, active: null, eggUsage: excess, eggTier: null, pendingHatch: null };
+  }
+  return { state: next, events };
 }
-function decideGrant(input) {
-  if (grantSize(input.window) === 0)
-    return { grant: false };
-  if (input.lastGrantedAt === null)
-    return { grant: false, seedAt: input.now };
-  if (input.now - input.lastGrantedAt < WINDOW_MS[input.window])
-    return { grant: false };
-  return { grant: true, count: grantSize(input.window), at: input.now };
+function stampedAt(stageTimes, index, now) {
+  const placed = [...stageTimes];
+  while (placed.length <= index)
+    placed.push(null);
+  placed[index] ??= now;
+  return placed;
 }
 
-// src/pokeapi.ts
-var POKEAPI_ORIGIN = "https://pokeapi.co";
-var SPRITE_ORIGIN = "https://raw.githubusercontent.com";
-var SPRITE_DIR = "/PokeAPI/sprites/master/sprites/pokemon/versions/generation-v/black-white/animated";
-var ITEM_SPRITE_DIR = "/PokeAPI/sprites/master/sprites/items";
-var MAX_EVOLUTION_CHAIN_ID = 2000;
-var INDEX_FETCH_CONCURRENCY = 8;
-var INDEX_PATH = "species/index.json";
-var speciesPath = (id) => `species/${id}.json`;
-var chainPath = (chainId) => `species/chain-${chainId}.json`;
-var spritePath = (id, shiny) => shiny ? `sprites/shiny/${id}.gif` : `sprites/${id}.gif`;
-var itemSpritePath = (name) => `sprites/items/${name}.png`;
-function isFetchableSpeciesId(id) {
-  return Number.isInteger(id) && hasAnimatedSprite(id);
+// src/roll.ts
+var NATURES = [
+  "hardy",
+  "lonely",
+  "brave",
+  "adamant",
+  "naughty",
+  "bold",
+  "docile",
+  "relaxed",
+  "impish",
+  "lax",
+  "timid",
+  "hasty",
+  "serious",
+  "jolly",
+  "naive",
+  "modest",
+  "mild",
+  "quiet",
+  "bashful",
+  "rash",
+  "calm",
+  "gentle",
+  "sassy",
+  "careful",
+  "quirky"
+];
+function mulberry32(seed) {
+  let state = seed >>> 0;
+  return () => {
+    state = state + 1831565813 >>> 0;
+    let t = state;
+    t = Math.imul(t ^ t >>> 15, t | 1);
+    t ^= t + Math.imul(t ^ t >>> 7, t | 61);
+    return ((t ^ t >>> 14) >>> 0) / 4294967296;
+  };
 }
-function asRecord(value) {
-  if (typeof value !== "object" || value === null || Array.isArray(value))
+var COLLECTED_WEIGHT = 0.25;
+var FORM_WEIGHT = 0.6;
+function roll(input) {
+  const random = mulberry32(input.seed);
+  const eligibleWith = (withLure) => input.candidates.filter((candidate) => {
+    if (!hasAnimatedSprite(candidate.id))
+      return false;
+    if (candidate.id === DITTO_SPECIES_ID)
+      return false;
+    if (input.excludeFinal != null && candidate.finalId === input.excludeFinal)
+      return false;
+    if (withLure && input.collectedFinals.has(candidate.finalId))
+      return false;
+    if (input.guarantee === null)
+      return true;
+    const rarity2 = rarityFromCaptureRate(candidate.captureRate, false, false);
+    return sortRank(rarity2) >= sortRank(input.guarantee);
+  });
+  const wanted = input.onlyUncollected === true;
+  const lured = wanted ? eligibleWith(true) : [];
+  const usedLure = wanted && lured.length > 0;
+  const eligible = usedLure ? lured : eligibleWith(false);
+  if (eligible.length === 0)
     return null;
-  return value;
-}
-function asArray(value) {
-  return Array.isArray(value) ? value : null;
+  const weights = eligible.map((candidate) => {
+    const base = Math.max(1, candidate.captureRate);
+    const collected = input.collectedFinals.has(candidate.finalId) ? base * COLLECTED_WEIGHT : base;
+    return input.preferLongLines === true ? collected * (1 + FORM_WEIGHT * (Math.max(1, candidate.forms) - 1)) : collected;
+  });
+  const total = weights.reduce((a, b) => a + b, 0);
+  let target = random() * total;
+  let index = 0;
+  for (let i = 0;i < weights.length; i++) {
+    target -= weights[i];
+    if (target <= 0) {
+      index = i;
+      break;
+    }
+  }
+  const chosen = eligible[index];
+  const shinyDenominator = input.hasShinyCharm ? ODDS.shinyWithCharm : ODDS.shiny;
+  const isShiny = random() < 1 / shinyDenominator;
+  const nature = NATURES[Math.floor(random() * NATURES.length)];
+  const rarity = rarityFromCaptureRate(chosen.captureRate, false, false);
+  const dittoEligible = rarity === "common" && chosen.forms >= 2;
+  const ditto = dittoEligible && random() < 1 / ODDS.dittoDisguise;
+  return { speciesId: chosen.id, isShiny, nature, ditto, usedLure };
 }
-function asFiniteNumber(value) {
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
+
+// src/state.ts
+function emptyInventory() {
+  const inventory = {};
+  for (const kind of ITEM_KINDS)
+    inventory[kind] = 0;
+  return inventory;
 }
-var encoder = new TextEncoder;
-var decoder = new TextDecoder;
-async function readJson(deps, path) {
-  try {
-    const bytes = await deps.files.read(path);
-    if (bytes === null)
-      return null;
-    return JSON.parse(decoder.decode(bytes));
-  } catch {
-    return null;
-  }
+function freshState() {
+  return {
+    consumedTotal: 0,
+    active: null,
+    eggUsage: 0,
+    eggTier: null,
+    pendingHatch: null,
+    pendingReveal: null,
+    lure: false,
+    incense: false,
+    repel: null,
+    inventory: emptyInventory()
+  };
 }
-async function writeCache(deps, path, bytes) {
-  try {
-    await deps.files.write(path, bytes);
-  } catch {}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-async function writeJson(deps, path, value) {
-  await writeCache(deps, path, encoder.encode(JSON.stringify(value)));
+function asInt(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) ? Math.trunc(value) : fallback;
 }
-async function fetchJson(deps, url) {
-  try {
-    const response = await deps.net(url);
-    if (!response.ok)
-      return null;
-    return JSON.parse(await response.text());
-  } catch {
-    return null;
-  }
+function asRarity(value) {
+  return RARITIES.includes(value) ? value : null;
 }
-async function fetchBytes(deps, url) {
+function parseState(raw) {
+  let parsed;
   try {
-    const response = await deps.net(url);
-    if (!response.ok)
-      return null;
-    const bytes = new Uint8Array(await response.arrayBuffer());
-    return bytes.length === 0 ? null : bytes;
+    parsed = JSON.parse(raw);
   } catch {
     return null;
   }
-}
-var CHAIN_URL_ID = /\/evolution-chain\/(\d+)\/?$/;
-function chainIdFromUrl(url) {
-  if (typeof url !== "string")
-    return null;
-  const match = CHAIN_URL_ID.exec(url);
-  if (match === null)
-    return null;
-  const id = Number(match[1]);
-  if (!Number.isInteger(id) || id < 1 || id > MAX_EVOLUTION_CHAIN_ID)
-    return null;
-  return id;
-}
-var SPECIES_URL_ID = /\/pokemon-species\/(\d+)\/?$/;
-function speciesIdFromUrl(url) {
-  if (typeof url !== "string")
-    return null;
-  const match = SPECIES_URL_ID.exec(url);
-  if (match === null)
-    return null;
-  const id = Number(match[1]);
-  return isFetchableSpeciesId(id) ? id : null;
-}
-function parseChainNode(raw) {
-  const node = asRecord(raw);
-  if (node === null)
-    return null;
-  const species = asRecord(node.species);
-  const id = speciesIdFromUrl(species?.url);
-  if (id === null)
+  if (!isRecord(parsed))
     return null;
-  const children = asArray(node.evolves_to) ?? [];
-  const evolvesTo = [];
-  for (const child of children) {
-    const parsed = parseChainNode(child);
-    if (parsed !== null)
-      evolvesTo.push(parsed);
+  const inventory = emptyInventory();
+  const storedInventory = parsed.inventory;
+  if (isRecord(storedInventory)) {
+    for (const kind of ITEM_KINDS) {
+      inventory[kind] = Math.max(0, asInt(storedInventory[kind], 0));
+    }
   }
-  return { id, evolvesTo };
-}
-function pathTo(node, id) {
-  if (node.id === id)
-    return [id];
-  for (const child of node.evolvesTo) {
-    const tail = pathTo(child, id);
-    if (tail !== null)
-      return [node.id, ...tail];
+  let active = null;
+  const storedActive = parsed.active;
+  if (storedActive !== null && storedActive !== undefined) {
+    if (!isRecord(storedActive))
+      return null;
+    const rarity = asRarity(storedActive.rarity);
+    if (rarity === null)
+      return null;
+    const path = Array.isArray(storedActive.plannedPath) ? storedActive.plannedPath.filter((id) => typeof id === "number" && id > 0) : [];
+    if (path.length === 0)
+      return null;
+    const nature = NATURES.includes(storedActive.nature) ? storedActive.nature : null;
+    active = {
+      baseId: asInt(storedActive.baseId, path[0]),
+      plannedPath: path,
+      stageIndex: Math.min(Math.max(0, asInt(storedActive.stageIndex, 0)), path.length - 1),
+      stageTimes: Array.isArray(storedActive.stageTimes) ? storedActive.stageTimes.map((at) => typeof at === "number" && at >= 0 && Number.isFinite(at) ? at : null) : [],
+      usedAtStage: Math.max(0, asInt(storedActive.usedAtStage, 0)),
+      rarity,
+      isShiny: storedActive.isShiny === true,
+      nature: nature ?? "hardy",
+      dittoDisguise: typeof storedActive.dittoDisguise === "number" ? storedActive.dittoDisguise : null,
+      dittoRevealed: storedActive.dittoRevealed === true,
+      everstone: storedActive.everstone === true,
+      soothe: storedActive.soothe === true,
+      soothedRaw: Math.max(0, asInt(storedActive.soothedRaw, 0))
+    };
   }
-  return null;
-}
-function descendFirstBranch(node) {
-  const rest = [];
-  let current = node;
-  while (current.evolvesTo.length > 0) {
-    const next = current.evolvesTo[0];
-    rest.push(next.id);
-    current = next;
+  const storedPending = parsed.pendingHatch;
+  let pendingHatch = null;
+  if (isRecord(storedPending)) {
+    const rarity = asRarity(storedPending.rarity);
+    const path = Array.isArray(storedPending.path) ? storedPending.path.filter((id) => typeof id === "number" && id > 0) : [];
+    if (rarity !== null && path.length > 0) {
+      const nature = NATURES.includes(storedPending.nature) ? storedPending.nature : "hardy";
+      pendingHatch = {
+        speciesId: asInt(storedPending.speciesId, path[0]),
+        path,
+        rarity,
+        isShiny: storedPending.isShiny === true,
+        nature,
+        ditto: storedPending.ditto === true
+      };
+    }
   }
-  return rest;
-}
-function lineThrough(root, id) {
-  const prefix = pathTo(root, id);
-  if (prefix === null)
+  const storedReveal = parsed.pendingReveal;
+  let pendingReveal = null;
+  if (isRecord(storedReveal)) {
+    const rarity = asRarity(storedReveal.rarity);
+    const path = Array.isArray(storedReveal.path) ? storedReveal.path.filter((id) => typeof id === "number" && id > 0) : [];
+    if (rarity !== null && path.length > 0)
+      pendingReveal = { path, rarity };
+  }
+  const storedConsumed = parsed.consumedTotal;
+  if (typeof storedConsumed !== "number" || !Number.isFinite(storedConsumed))
     return null;
-  const self = prefix[prefix.length - 1];
-  const node = nodeFor(root, self);
-  return node === null ? prefix : [...prefix, ...descendFirstBranch(node)];
+  const eggTier = asRarity(parsed.eggTier);
+  return {
+    consumedTotal: Math.max(0, Math.trunc(storedConsumed)),
+    active,
+    eggUsage: Math.max(0, asInt(parsed.eggUsage, 0)),
+    eggTier: eggTier === null || eggTier === "legendary" ? null : eggTier,
+    pendingHatch,
+    pendingReveal,
+    lure: parsed.lure === true,
+    incense: parsed.incense === true,
+    repel: typeof parsed.repel === "number" && Number.isInteger(parsed.repel) && parsed.repel > 0 ? parsed.repel : null,
+    inventory
+  };
 }
-function nodeFor(node, id) {
-  if (node.id === id)
-    return node;
-  for (const child of node.evolvesTo) {
-    const found = nodeFor(child, id);
-    if (found !== null)
-      return found;
-  }
-  return null;
+function serialiseState(state) {
+  return JSON.stringify(state);
 }
-function loadChain(deps, chainId, cache) {
-  const inFlight = cache.get(chainId);
-  if (inFlight !== undefined)
-    return inFlight;
-  const pending = (async () => {
-    const path = chainPath(chainId);
-    const cached = await readJson(deps, path);
-    if (cached !== null) {
-      const parsed2 = parseChainNode(cached);
-      if (parsed2 !== null)
-        return parsed2;
-    }
-    const fetched = await fetchJson(deps, `${POKEAPI_ORIGIN}/api/v2/evolution-chain/${chainId}`);
-    if (fetched === null)
-      return null;
-    const root = asRecord(fetched)?.chain;
-    const parsed = parseChainNode(root);
-    if (parsed === null)
-      return null;
-    await writeJson(deps, path, { chain: root });
-    return parsed;
-  })();
-  cache.set(chainId, pending);
-  return pending;
+function hasShinyCharm(state) {
+  return (state.inventory.shinyCharm ?? 0) > 0;
 }
-function parseNames(raw) {
-  const names = {};
-  for (const entry of asArray(raw) ?? []) {
-    const record = asRecord(entry);
-    if (record === null)
-      continue;
-    const language = asRecord(record.language)?.name;
-    const name = record.name;
-    if (typeof language === "string" && typeof name === "string")
-      names[language] = name;
+
+// src/store.ts
+var MIGRATIONS = [
+  {
+    version: 1,
+    sql: `
+      CREATE TABLE {{companion}} (
+        api_key_id   TEXT PRIMARY KEY,
+        state        TEXT NOT NULL,
+        tokens_total INTEGER NOT NULL DEFAULT 0,
+        tokens_spent INTEGER NOT NULL DEFAULT 0,
+        created_at   INTEGER NOT NULL,
+        updated_at   INTEGER NOT NULL
+      )
+    `
+  },
+  {
+    version: 2,
+    sql: `
+      CREATE TABLE {{dex}} (
+        id          TEXT PRIMARY KEY,
+        api_key_id  TEXT NOT NULL,
+        base_id     INTEGER NOT NULL,
+        final_id    INTEGER NOT NULL,
+        chain_order TEXT NOT NULL,
+        rarity      TEXT NOT NULL,
+        is_shiny    INTEGER NOT NULL DEFAULT 0,
+        nature      TEXT,
+        caught_at   INTEGER NOT NULL
+      )
+    `
+  },
+  {
+    version: 3,
+    sql: `CREATE INDEX {{dex_by_key}} ON {{dex}} (api_key_id, caught_at DESC)`
+  },
+  {
+    version: 4,
+    sql: `
+      CREATE TABLE {{grants}} (
+        api_key_id TEXT NOT NULL,
+        window_key TEXT NOT NULL,
+        -- An instant, not a tier. A grant is rate-limited by the window's own
+        -- duration, because nothing tells this plugin when a window empties.
+        granted_at INTEGER NOT NULL,
+        PRIMARY KEY (api_key_id, window_key)
+      )
+    `
+  },
+  {
+    version: 5,
+    sql: `ALTER TABLE {{companion}} ADD COLUMN last_credit_at INTEGER`
+  },
+  {
+    version: 6,
+    sql: `ALTER TABLE {{dex}} ADD COLUMN stage_times TEXT`
+  },
+  {
+    version: 7,
+    sql: `
+      CREATE TABLE {{sightings}} (
+        api_key_id  TEXT NOT NULL,
+        species_id  INTEGER NOT NULL,
+        -- The line this individual was on, so a species seen but never
+        -- graduated still has a chain to draw. There is no Dex row to take one
+        -- from, and a record with no line is a sprite with nothing under it.
+        chain_order TEXT NOT NULL,
+        rarity      TEXT NOT NULL,
+        is_shiny    INTEGER NOT NULL DEFAULT 0,
+        seen_at     INTEGER NOT NULL,
+        PRIMARY KEY (api_key_id, species_id)
+      )
+    `
   }
-  return names;
+];
+function wallet(row) {
+  return Math.max(0, row.tokensTotal - row.tokensSpent);
 }
-function parseCachedDetail(raw, id) {
-  const record = asRecord(raw);
-  if (record === null)
-    return null;
-  const captureRate = asFiniteNumber(record.captureRate);
-  if (captureRate === null)
-    return null;
-  const chainRaw = asArray(record.chain);
-  if (chainRaw === null || chainRaw.length === 0)
+function readCompanion(storage, apiKeyId) {
+  const row = storage.get(`SELECT api_key_id, state, tokens_total, tokens_spent, last_credit_at
+     FROM {{companion}} WHERE api_key_id = ?`, [apiKeyId]);
+  if (row === null)
     return null;
-  const chain = [];
-  for (const entry of chainRaw) {
-    if (typeof entry !== "number" || !isFetchableSpeciesId(entry))
-      return null;
-    chain.push(entry);
-  }
   return {
-    id,
-    names: parseNames(record.names),
-    captureRate,
-    isLegendary: record.isLegendary === true,
-    isMythical: record.isMythical === true,
-    chain
+    apiKeyId: row.api_key_id,
+    state: parseState(row.state),
+    tokensTotal: row.tokens_total,
+    tokensSpent: row.tokens_spent,
+    lastCreditAt: row.last_credit_at
   };
 }
-function detailToCache(detail) {
-  return {
-    captureRate: detail.captureRate,
-    isLegendary: detail.isLegendary,
-    isMythical: detail.isMythical,
-    chain: detail.chain,
-    names: Object.entries(detail.names).map(([language, name]) => ({
-      language: { name: language },
-      name
-    }))
-  };
+function listCompanions(storage) {
+  const rows = storage.all(`SELECT api_key_id, state, tokens_total, tokens_spent, last_credit_at
+     FROM {{companion}}
+     ORDER BY last_credit_at IS NULL, last_credit_at DESC, tokens_total DESC, api_key_id ASC`);
+  return rows.map((row) => ({
+    apiKeyId: row.api_key_id,
+    state: parseState(row.state),
+    tokensTotal: row.tokens_total,
+    tokensSpent: row.tokens_spent,
+    lastCreditAt: row.last_credit_at
+  }));
+}
+function creditTokens(storage, apiKeyId, tokens, now) {
+  if (tokens <= 0)
+    return;
+  storage.run(`INSERT INTO {{companion}} (api_key_id, state, tokens_total, tokens_spent, created_at, updated_at, last_credit_at)
+     VALUES (?, ?, ?, 0, ?, ?, ?)
+     ON CONFLICT(api_key_id) DO UPDATE SET
+       tokens_total = tokens_total + excluded.tokens_total,
+       updated_at = excluded.updated_at,
+       last_credit_at = excluded.last_credit_at`, [apiKeyId, serialiseState(freshState()), Math.trunc(tokens), now, now, now]);
+}
+function settle(storage, apiKeyId, now) {
+  const row = readCompanion(storage, apiKeyId);
+  if (row === null)
+    return null;
+  if (row.state === null)
+    return { row, events: [] };
+  const result = advance(row.state, row.tokensTotal, now);
+  if (result.events.length === 0 && result.state === row.state)
+    return { row, events: [] };
+  storage.run("UPDATE {{companion}} SET state = ?, updated_at = ? WHERE api_key_id = ?", [
+    serialiseState(result.state),
+    now,
+    apiKeyId
+  ]);
+  return { row: { ...row, state: result.state }, events: result.events };
+}
+function recordGraduation(storage, apiKeyId, entry, id) {
+  storage.run(`INSERT INTO {{dex}} (id, api_key_id, base_id, final_id, chain_order, stage_times, rarity, is_shiny, nature, caught_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    apiKeyId,
+    entry.baseId,
+    entry.finalId,
+    JSON.stringify(entry.chainOrder),
+    entry.stageTimes === null ? null : JSON.stringify(entry.stageTimes),
+    entry.rarity,
+    entry.isShiny ? 1 : 0,
+    entry.nature,
+    entry.caughtAt
+  ]);
 }
-async function loadDetail(deps, id, chains) {
-  if (!isFetchableSpeciesId(id))
-    return null;
-  const path = speciesPath(id);
-  const cached = parseCachedDetail(await readJson(deps, path), id);
-  if (cached !== null)
-    return cached;
-  const raw = asRecord(await fetchJson(deps, `${POKEAPI_ORIGIN}/api/v2/pokemon-species/${id}`));
-  if (raw === null)
-    return null;
-  const captureRate = asFiniteNumber(raw.capture_rate);
-  if (captureRate === null)
+function parseChain(raw) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
     return null;
-  const chainId = chainIdFromUrl(asRecord(raw.evolution_chain)?.url);
-  if (chainId === null)
+  }
+  if (!Array.isArray(parsed))
     return null;
-  const root = await loadChain(deps, chainId, chains);
-  if (root === null)
+  const chain = parsed.filter((id) => typeof id === "number");
+  return chain.length === 0 ? null : chain;
+}
+function parseStageTimes(raw) {
+  if (raw === null)
     return null;
-  const chain = lineThrough(root, id);
-  if (chain === null || chain.length === 0)
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
     return null;
-  const detail = {
-    id,
-    names: parseNames(raw.names),
-    captureRate,
-    isLegendary: raw.is_legendary === true,
-    isMythical: raw.is_mythical === true,
-    chain
-  };
-  await writeJson(deps, path, detailToCache(detail));
-  return detail;
-}
-function speciesDetail(deps, id) {
-  return loadDetail(deps, id, new Map);
-}
-function speciesDetails(deps, ids) {
-  const chains = new Map;
-  return Promise.all(ids.map((id) => loadDetail(deps, id, chains)));
-}
-async function cachedSpeciesName(deps, id) {
-  if (!isFetchableSpeciesId(id))
+  }
+  if (!Array.isArray(parsed))
     return null;
-  const cached = parseCachedDetail(await readJson(deps, speciesPath(id)), id);
-  return cached?.names.en ?? null;
+  return parsed.map((at) => typeof at === "number" && Number.isFinite(at) ? at : null);
 }
-function parseCachedIndex(raw) {
-  const entries = asArray(raw);
-  if (entries === null)
-    return null;
-  const candidates = [];
-  for (const entry of entries) {
-    const record = asRecord(entry);
-    if (record === null)
-      return null;
-    const id = asFiniteNumber(record.id);
-    const captureRate = asFiniteNumber(record.captureRate);
-    const forms = asFiniteNumber(record.forms);
-    const finalId = asFiniteNumber(record.finalId);
-    if (id === null || captureRate === null || forms === null || finalId === null)
-      return null;
-    if (!isFetchableSpeciesId(id))
-      return null;
-    candidates.push({ id, captureRate, forms, finalId });
+function readDex(storage, apiKeyId) {
+  const rows = storage.all(`SELECT id, base_id, final_id, chain_order, stage_times, rarity, is_shiny, nature, caught_at
+     FROM {{dex}} WHERE api_key_id = ? ORDER BY caught_at DESC`, [apiKeyId]);
+  const entries = [];
+  for (const row of rows) {
+    const chain = parseChain(row.chain_order);
+    if (chain === null)
+      continue;
+    entries.push({
+      id: row.id,
+      baseId: row.base_id,
+      finalId: row.final_id,
+      chainOrder: chain,
+      stageTimes: parseStageTimes(row.stage_times),
+      rarity: row.rarity,
+      isShiny: row.is_shiny === 1,
+      nature: row.nature,
+      caughtAt: row.caught_at
+    });
   }
-  return candidates.length === 0 ? null : candidates;
+  return entries;
 }
-async function mapWithConcurrency(ids, limit, worker) {
-  const results = new Array(ids.length);
-  let next = 0;
-  const runners = Array.from({ length: Math.min(limit, ids.length) }, async () => {
-    while (next < ids.length) {
-      const index = next++;
-      results[index] = await worker(ids[index]);
-    }
-  });
-  await Promise.all(runners);
-  return results;
+function recordSightings(storage, apiKeyId, reached, now) {
+  if (reached.disguised)
+    return;
+  const chain = JSON.stringify(reached.plannedPath);
+  const stages = reached.plannedPath.slice(0, reached.stageIndex + 1);
+  for (const [stage, speciesId] of stages.entries()) {
+    storage.run(`INSERT INTO {{sightings}} (api_key_id, species_id, chain_order, rarity, is_shiny, seen_at)
+       VALUES (?, ?, ?, ?, ?, ?)
+       ON CONFLICT(api_key_id, species_id) DO NOTHING`, [
+      apiKeyId,
+      speciesId,
+      chain,
+      reached.rarity,
+      reached.isShiny ? 1 : 0,
+      reached.stageTimes[stage] ?? now
+    ]);
+  }
 }
-async function speciesIndex(deps) {
-  const cached = parseCachedIndex(await readJson(deps, INDEX_PATH));
-  if (cached !== null)
-    return cached;
-  const ids = Array.from({ length: ANIMATED_SPECIES_MAX }, (_, i) => i + 1);
-  const chains = new Map;
-  const details = await mapWithConcurrency(ids, INDEX_FETCH_CONCURRENCY, (id) => loadDetail(deps, id, chains));
-  const candidates = [];
-  for (const detail of details) {
-    if (detail === null)
-      continue;
-    if (detail.chain[0] !== detail.id)
+function listSightings(storage, apiKeyId) {
+  const rows = storage.all(`SELECT species_id, chain_order, rarity, is_shiny, seen_at
+     FROM {{sightings}} WHERE api_key_id = ? ORDER BY species_id ASC`, [apiKeyId]);
+  const sightings = [];
+  for (const row of rows) {
+    const chain = parseChain(row.chain_order);
+    if (chain === null)
       continue;
-    candidates.push({
-      id: detail.id,
-      captureRate: detail.captureRate,
-      forms: detail.chain.length,
-      finalId: detail.chain[detail.chain.length - 1] ?? detail.id
+    sightings.push({
+      speciesId: row.species_id,
+      chainOrder: chain,
+      rarity: row.rarity,
+      isShiny: row.is_shiny === 1,
+      seenAt: row.seen_at
     });
   }
-  if (details.every((detail) => detail !== null))
-    await writeJson(deps, INDEX_PATH, candidates);
-  return candidates;
+  return sightings;
 }
-async function spriteBytes(deps, id, shiny) {
-  if (!isFetchableSpeciesId(id))
-    return null;
-  const path = spritePath(id, shiny);
-  try {
-    const cached = await deps.files.read(path);
-    if (cached !== null && cached.length > 0)
-      return cached;
-  } catch {}
-  const url = shiny ? `${SPRITE_ORIGIN}${SPRITE_DIR}/shiny/${id}.gif` : `${SPRITE_ORIGIN}${SPRITE_DIR}/${id}.gif`;
-  const bytes = await fetchBytes(deps, url);
-  if (bytes === null)
-    return null;
-  await writeCache(deps, path, bytes);
-  return bytes;
+function lastGrantedAt(storage, apiKeyId, windowKey) {
+  const row = storage.get("SELECT granted_at FROM {{grants}} WHERE api_key_id = ? AND window_key = ?", [apiKeyId, windowKey]);
+  return row?.granted_at ?? null;
 }
-async function itemSpriteBytes(deps, item) {
-  const name = ITEM_SPRITE_NAMES.get(item);
-  if (name === undefined)
-    return null;
-  const path = itemSpritePath(name);
-  try {
-    const cached = await deps.files.read(path);
-    if (cached !== null && cached.length > 0)
-      return cached;
-  } catch {}
-  const bytes = await fetchBytes(deps, `${SPRITE_ORIGIN}${ITEM_SPRITE_DIR}/${name}.png`);
-  if (bytes === null)
-    return null;
-  await writeCache(deps, path, bytes);
-  return bytes;
+function setGrantedAt(storage, apiKeyId, windowKey, at) {
+  storage.run(`INSERT INTO {{grants}} (api_key_id, window_key, granted_at) VALUES (?, ?, ?)
+     ON CONFLICT(api_key_id, window_key) DO UPDATE SET granted_at = excluded.granted_at`, [apiKeyId, windowKey, at]);
 }
-
-// src/roll.ts
-var NATURES = [
-  "hardy",
-  "lonely",
-  "brave",
-  "adamant",
-  "naughty",
-  "bold",
-  "docile",
-  "relaxed",
-  "impish",
-  "lax",
-  "timid",
-  "hasty",
-  "serious",
-  "jolly",
-  "naive",
-  "modest",
-  "mild",
-  "quiet",
-  "bashful",
-  "rash",
-  "calm",
-  "gentle",
-  "sassy",
-  "careful",
-  "quirky"
-];
-function mulberry32(seed) {
-  let state = seed >>> 0;
-  return () => {
-    state = state + 1831565813 >>> 0;
-    let t = state;
-    t = Math.imul(t ^ t >>> 15, t | 1);
-    t ^= t + Math.imul(t ^ t >>> 7, t | 61);
-    return ((t ^ t >>> 14) >>> 0) / 4294967296;
-  };
+function shopPrice(entry) {
+  return entry.kind === "item" ? ITEM_PRICES[entry.item] : freshEggPrice(entry.tier);
 }
-var COLLECTED_WEIGHT = 0.25;
-var FORM_WEIGHT = 0.6;
-function roll(input) {
-  const random = mulberry32(input.seed);
-  const eligibleWith = (withLure) => input.candidates.filter((candidate) => {
-    if (!hasAnimatedSprite(candidate.id))
-      return false;
-    if (candidate.id === DITTO_SPECIES_ID)
-      return false;
-    if (input.excludeFinal != null && candidate.finalId === input.excludeFinal)
-      return false;
-    if (withLure && input.collectedFinals.has(candidate.finalId))
-      return false;
-    if (input.guarantee === null)
-      return true;
-    const rarity2 = rarityFromCaptureRate(candidate.captureRate, false, false);
-    return sortRank(rarity2) >= sortRank(input.guarantee);
-  });
-  const wanted = input.onlyUncollected === true;
-  const lured = wanted ? eligibleWith(true) : [];
-  const usedLure = wanted && lured.length > 0;
-  const eligible = usedLure ? lured : eligibleWith(false);
-  if (eligible.length === 0)
-    return null;
-  const weights = eligible.map((candidate) => {
-    const base = Math.max(1, candidate.captureRate);
-    const collected = input.collectedFinals.has(candidate.finalId) ? base * COLLECTED_WEIGHT : base;
-    return input.preferLongLines === true ? collected * (1 + FORM_WEIGHT * (Math.max(1, candidate.forms) - 1)) : collected;
-  });
-  const total = weights.reduce((a, b) => a + b, 0);
-  let target = random() * total;
-  let index = 0;
-  for (let i = 0;i < weights.length; i++) {
-    target -= weights[i];
-    if (target <= 0) {
-      index = i;
-      break;
+function consume(storage, apiKeyId, item, applyToState, now) {
+  const row = readCompanion(storage, apiKeyId);
+  if (row === null)
+    return { ok: false, reason: "missing" };
+  if (row.state === null)
+    return { ok: false, reason: "unreadable" };
+  if ((row.state.inventory[item] ?? 0) <= 0)
+    return { ok: false, reason: "none-held" };
+  const outcome = applyToState(row.state);
+  if ("refused" in outcome)
+    return { ok: false, reason: outcome.refused };
+  const nextState = {
+    ...outcome.applied,
+    inventory: {
+      ...outcome.applied.inventory,
+      [item]: (outcome.applied.inventory[item] ?? 0) - 1
     }
+  };
+  storage.run("UPDATE {{companion}} SET state = ?, updated_at = ? WHERE api_key_id = ?", [
+    serialiseState(nextState),
+    now,
+    apiKeyId
+  ]);
+  return { ok: true, row: { ...row, state: nextState } };
+}
+function purchase(storage, apiKeyId, entry, applyToState, now) {
+  const price = shopPrice(entry);
+  {
+    const row = readCompanion(storage, apiKeyId);
+    if (row === null)
+      return { ok: false, reason: "missing" };
+    if (row.state === null)
+      return { ok: false, reason: "unreadable" };
+    if (wallet(row) < price)
+      return { ok: false, reason: "insufficient" };
+    const outcome = applyToState(row.state);
+    if ("refused" in outcome)
+      return { ok: false, reason: outcome.refused };
+    const nextState = outcome.applied;
+    storage.run("UPDATE {{companion}} SET state = ?, tokens_spent = tokens_spent + ?, updated_at = ? WHERE api_key_id = ?", [serialiseState(nextState), price, now, apiKeyId]);
+    return {
+      ok: true,
+      row: { ...row, state: nextState, tokensSpent: row.tokensSpent + price }
+    };
   }
-  const chosen = eligible[index];
-  const shinyDenominator = input.hasShinyCharm ? ODDS.shinyWithCharm : ODDS.shiny;
-  const isShiny = random() < 1 / shinyDenominator;
-  const nature = NATURES[Math.floor(random() * NATURES.length)];
-  const rarity = rarityFromCaptureRate(chosen.captureRate, false, false);
-  const dittoEligible = rarity === "common" && chosen.forms >= 2;
-  const ditto = dittoEligible && random() < 1 / ODDS.dittoDisguise;
-  return { speciesId: chosen.id, isShiny, nature, ditto, usedLure };
 }
 
-// src/state.ts
-function emptyInventory() {
-  const inventory = {};
-  for (const kind of ITEM_KINDS)
-    inventory[kind] = 0;
-  return inventory;
+// src/collection.ts
+function collect(entries, sightings = []) {
+  const bySpecies = new Map;
+  const contributions = [...entries.flatMap(contributionsOf), ...sightings.map(contributionOf)];
+  for (const { speciesId, stamp, exact, source, taken } of contributions) {
+    const found = bySpecies.get(speciesId);
+    if (found === undefined) {
+      bySpecies.set(speciesId, {
+        rarity: source.rarity,
+        isShiny: source.isShiny,
+        first: stamp,
+        firstExact: exact,
+        catches: taken === null ? [] : [taken],
+        lines: new Map([[lineKey(source.chainOrder), source.chainOrder]])
+      });
+      continue;
+    }
+    if (taken !== null)
+      found.catches.push(taken);
+    found.isShiny = found.isShiny || source.isShiny;
+    if (earlier(stamp, found.first)) {
+      found.rarity = source.rarity;
+      found.first = stamp;
+      found.firstExact = exact;
+    }
+    const key = lineKey(source.chainOrder);
+    if (!found.lines.has(key))
+      found.lines.set(key, source.chainOrder);
+  }
+  return [...bySpecies].map(([speciesId, found]) => ({
+    speciesId,
+    rarity: found.rarity,
+    isShiny: found.isShiny,
+    firstCaughtAt: found.first.caughtAt,
+    firstCaughtExact: found.firstExact,
+    lines: [...found.lines.values()],
+    catches: [...found.catches].sort((a, b) => (b.enteredAt ?? b.caughtAt) - (a.enteredAt ?? a.caughtAt) || byId(a.id, b.id))
+  })).sort((a, b) => a.speciesId - b.speciesId);
+}
+function readCollection(storage, apiKeyId) {
+  return collect(readDex(storage, apiKeyId), listSightings(storage, apiKeyId));
+}
+function contributionsOf(entry) {
+  return entry.chainOrder.map((speciesId) => {
+    const enteredAt = enteredAtOf(entry, speciesId);
+    return {
+      speciesId,
+      stamp: { id: entry.id, caughtAt: enteredAt ?? entry.caughtAt },
+      exact: enteredAt !== null,
+      source: entry,
+      taken: {
+        id: entry.id,
+        chainOrder: entry.chainOrder,
+        isShiny: entry.isShiny,
+        nature: entry.nature,
+        caughtAt: entry.caughtAt,
+        enteredAt
+      }
+    };
+  });
 }
-function freshState() {
+function contributionOf(sighting) {
   return {
-    consumedTotal: 0,
-    active: null,
-    eggUsage: 0,
-    eggTier: null,
-    pendingHatch: null,
-    pendingReveal: null,
-    lure: false,
-    incense: false,
-    repel: null,
-    inventory: emptyInventory()
+    speciesId: sighting.speciesId,
+    stamp: { id: `seen-${sighting.speciesId}`, caughtAt: sighting.seenAt },
+    exact: true,
+    source: sighting,
+    taken: null
   };
 }
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
+function lineKey(chainOrder) {
+  return chainOrder.join("-");
 }
-function asInt(value, fallback) {
-  return typeof value === "number" && Number.isFinite(value) ? Math.trunc(value) : fallback;
+function enteredAtOf(entry, speciesId) {
+  if (entry.stageTimes === null)
+    return null;
+  const stage = entry.chainOrder.indexOf(speciesId);
+  if (stage < 0)
+    return null;
+  return entry.stageTimes[stage] ?? null;
 }
-function asRarity(value) {
-  return RARITIES.includes(value) ? value : null;
+function earlier(a, b) {
+  if (a.caughtAt !== b.caughtAt)
+    return a.caughtAt < b.caughtAt;
+  return byId(a.id, b.id) < 0;
 }
-function parseState(raw) {
-  let parsed;
+function byId(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+
+// node_modules/@omnigateway/plugin-api/src/events.ts
+var WINDOW_MS = {
+  "1m": 60000,
+  "5h": 5 * 60 * 60 * 1000,
+  "1w": 7 * 24 * 60 * 60 * 1000
+};
+
+// src/grants.ts
+function windowKey(event) {
+  return `${event.dimension}:${event.window}`;
+}
+function grantSize(window) {
+  if (window === "1w")
+    return 5;
+  if (window === "5h")
+    return 1;
+  return 0;
+}
+function decideGrant(input) {
+  if (grantSize(input.window) === 0)
+    return { grant: false };
+  if (input.lastGrantedAt === null)
+    return { grant: false, seedAt: input.now };
+  if (input.now - input.lastGrantedAt < WINDOW_MS[input.window])
+    return { grant: false };
+  return { grant: true, count: grantSize(input.window), at: input.now };
+}
+
+// src/pokeapi.ts
+var POKEAPI_ORIGIN = "https://pokeapi.co";
+var SPRITE_ORIGIN = "https://raw.githubusercontent.com";
+var SPRITE_DIR = "/PokeAPI/sprites/master/sprites/pokemon/versions/generation-v/black-white/animated";
+var ITEM_SPRITE_DIR = "/PokeAPI/sprites/master/sprites/items";
+var MAX_EVOLUTION_CHAIN_ID = 2000;
+var INDEX_FETCH_CONCURRENCY = 8;
+var INDEX_PATH = "species/index.json";
+var speciesPath = (id) => `species/${id}.json`;
+var chainPath = (chainId) => `species/chain-${chainId}.json`;
+var spritePath = (id, shiny) => shiny ? `sprites/shiny/${id}.gif` : `sprites/${id}.gif`;
+var itemSpritePath = (name) => `sprites/items/${name}.png`;
+function isFetchableSpeciesId(id) {
+  return Number.isInteger(id) && hasAnimatedSprite(id);
+}
+function asRecord(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value))
+    return null;
+  return value;
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : null;
+}
+function asFiniteNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+var encoder = new TextEncoder;
+var decoder = new TextDecoder;
+async function readJson(deps, path) {
   try {
-    parsed = JSON.parse(raw);
+    const bytes = await deps.files.read(path);
+    if (bytes === null)
+      return null;
+    return JSON.parse(decoder.decode(bytes));
   } catch {
     return null;
   }
-  if (!isRecord(parsed))
+}
+async function writeCache(deps, path, bytes) {
+  try {
+    await deps.files.write(path, bytes);
+  } catch {}
+}
+async function writeJson(deps, path, value) {
+  await writeCache(deps, path, encoder.encode(JSON.stringify(value)));
+}
+async function fetchJson(deps, url) {
+  try {
+    const response = await deps.net(url);
+    if (!response.ok)
+      return null;
+    return JSON.parse(await response.text());
+  } catch {
     return null;
-  const inventory = emptyInventory();
-  const storedInventory = parsed.inventory;
-  if (isRecord(storedInventory)) {
-    for (const kind of ITEM_KINDS) {
-      inventory[kind] = Math.max(0, asInt(storedInventory[kind], 0));
-    }
   }
-  let active = null;
-  const storedActive = parsed.active;
-  if (storedActive !== null && storedActive !== undefined) {
-    if (!isRecord(storedActive))
-      return null;
-    const rarity = asRarity(storedActive.rarity);
-    if (rarity === null)
-      return null;
-    const path = Array.isArray(storedActive.plannedPath) ? storedActive.plannedPath.filter((id) => typeof id === "number" && id > 0) : [];
-    if (path.length === 0)
+}
+async function fetchBytes(deps, url) {
+  try {
+    const response = await deps.net(url);
+    if (!response.ok)
       return null;
-    const nature = NATURES.includes(storedActive.nature) ? storedActive.nature : null;
-    active = {
-      baseId: asInt(storedActive.baseId, path[0]),
-      plannedPath: path,
-      stageIndex: Math.min(Math.max(0, asInt(storedActive.stageIndex, 0)), path.length - 1),
-      usedAtStage: Math.max(0, asInt(storedActive.usedAtStage, 0)),
-      rarity,
-      isShiny: storedActive.isShiny === true,
-      nature: nature ?? "hardy",
-      dittoDisguise: typeof storedActive.dittoDisguise === "number" ? storedActive.dittoDisguise : null,
-      dittoRevealed: storedActive.dittoRevealed === true,
-      everstone: storedActive.everstone === true,
-      soothe: storedActive.soothe === true,
-      soothedRaw: Math.max(0, asInt(storedActive.soothedRaw, 0))
-    };
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    return bytes.length === 0 ? null : bytes;
+  } catch {
+    return null;
   }
-  const storedPending = parsed.pendingHatch;
-  let pendingHatch = null;
-  if (isRecord(storedPending)) {
-    const rarity = asRarity(storedPending.rarity);
-    const path = Array.isArray(storedPending.path) ? storedPending.path.filter((id) => typeof id === "number" && id > 0) : [];
-    if (rarity !== null && path.length > 0) {
-      const nature = NATURES.includes(storedPending.nature) ? storedPending.nature : "hardy";
-      pendingHatch = {
-        speciesId: asInt(storedPending.speciesId, path[0]),
-        path,
-        rarity,
-        isShiny: storedPending.isShiny === true,
-        nature,
-        ditto: storedPending.ditto === true
-      };
-    }
+}
+var CHAIN_URL_ID = /\/evolution-chain\/(\d+)\/?$/;
+function chainIdFromUrl(url) {
+  if (typeof url !== "string")
+    return null;
+  const match = CHAIN_URL_ID.exec(url);
+  if (match === null)
+    return null;
+  const id = Number(match[1]);
+  if (!Number.isInteger(id) || id < 1 || id > MAX_EVOLUTION_CHAIN_ID)
+    return null;
+  return id;
+}
+var SPECIES_URL_ID = /\/pokemon-species\/(\d+)\/?$/;
+function speciesIdFromUrl(url) {
+  if (typeof url !== "string")
+    return null;
+  const match = SPECIES_URL_ID.exec(url);
+  if (match === null)
+    return null;
+  const id = Number(match[1]);
+  return isFetchableSpeciesId(id) ? id : null;
+}
+function parseChainNode(raw) {
+  const node = asRecord(raw);
+  if (node === null)
+    return null;
+  const species = asRecord(node.species);
+  const id = speciesIdFromUrl(species?.url);
+  if (id === null)
+    return null;
+  const children = asArray(node.evolves_to) ?? [];
+  const evolvesTo = [];
+  for (const child of children) {
+    const parsed = parseChainNode(child);
+    if (parsed !== null)
+      evolvesTo.push(parsed);
   }
-  const storedReveal = parsed.pendingReveal;
-  let pendingReveal = null;
-  if (isRecord(storedReveal)) {
-    const rarity = asRarity(storedReveal.rarity);
-    const path = Array.isArray(storedReveal.path) ? storedReveal.path.filter((id) => typeof id === "number" && id > 0) : [];
-    if (rarity !== null && path.length > 0)
-      pendingReveal = { path, rarity };
+  return { id, evolvesTo };
+}
+function pathTo(node, id) {
+  if (node.id === id)
+    return [id];
+  for (const child of node.evolvesTo) {
+    const tail = pathTo(child, id);
+    if (tail !== null)
+      return [node.id, ...tail];
   }
-  const storedConsumed = parsed.consumedTotal;
-  if (typeof storedConsumed !== "number" || !Number.isFinite(storedConsumed))
-    return null;
-  const eggTier = asRarity(parsed.eggTier);
-  return {
-    consumedTotal: Math.max(0, Math.trunc(storedConsumed)),
-    active,
-    eggUsage: Math.max(0, asInt(parsed.eggUsage, 0)),
-    eggTier: eggTier === null || eggTier === "legendary" ? null : eggTier,
-    pendingHatch,
-    pendingReveal,
-    lure: parsed.lure === true,
-    incense: parsed.incense === true,
-    repel: typeof parsed.repel === "number" && Number.isInteger(parsed.repel) && parsed.repel > 0 ? parsed.repel : null,
-    inventory
-  };
+  return null;
 }
-function serialiseState(state) {
-  return JSON.stringify(state);
+function descendFirstBranch(node) {
+  const rest = [];
+  let current = node;
+  while (current.evolvesTo.length > 0) {
+    const next = current.evolvesTo[0];
+    rest.push(next.id);
+    current = next;
+  }
+  return rest;
 }
-function hasShinyCharm(state) {
-  return (state.inventory.shinyCharm ?? 0) > 0;
+function lineThrough(root, id) {
+  const prefix = pathTo(root, id);
+  if (prefix === null)
+    return null;
+  const self = prefix[prefix.length - 1];
+  const node = nodeFor(root, self);
+  return node === null ? prefix : [...prefix, ...descendFirstBranch(node)];
 }
-
-// src/advance.ts
-var MAX_TRANSITIONS_PER_ADVANCE = 64;
-function advance(state, tokensTotal) {
-  const gained = Math.max(0, Math.trunc(tokensTotal) - state.consumedTotal);
-  const events = [];
-  let next = { ...state, consumedTotal: Math.trunc(tokensTotal) };
-  if (gained > 0) {
-    const active = next.active;
-    if (active === null) {
-      next = { ...next, eggUsage: next.eggUsage + gained };
-    } else if (!active.soothe) {
-      next = { ...next, active: { ...active, usedAtStage: active.usedAtStage + gained } };
-    } else {
-      const raw = active.soothedRaw + gained;
-      const owed = Math.floor(raw * SOOTHE_BONUS) - Math.floor(active.soothedRaw * SOOTHE_BONUS);
-      next = {
-        ...next,
-        active: { ...active, soothedRaw: raw, usedAtStage: active.usedAtStage + gained + owed }
-      };
-    }
+function nodeFor(node, id) {
+  if (node.id === id)
+    return node;
+  for (const child of node.evolvesTo) {
+    const found = nodeFor(child, id);
+    if (found !== null)
+      return found;
   }
-  for (let step = 0;step < MAX_TRANSITIONS_PER_ADVANCE; step++) {
-    if (next.active === null) {
-      if (next.eggUsage < EGG_HATCH_THRESHOLD)
-        break;
-      if (next.pendingHatch === null)
-        break;
-      const hatch = next.pendingHatch;
-      const active = {
-        baseId: hatch.path[0] ?? hatch.speciesId,
-        plannedPath: hatch.path,
-        stageIndex: 0,
-        usedAtStage: next.eggUsage - EGG_HATCH_THRESHOLD,
-        rarity: hatch.rarity,
-        isShiny: hatch.isShiny,
-        nature: hatch.nature,
-        dittoDisguise: hatch.ditto ? hatch.speciesId : null,
-        dittoRevealed: false,
-        everstone: false,
-        soothe: false,
-        soothedRaw: 0
-      };
-      events.push({
-        kind: "hatched",
-        speciesId: hatch.speciesId,
-        isShiny: active.isShiny,
-        ditto: active.dittoDisguise !== null
-      });
-      next = { ...next, active, eggUsage: 0, eggTier: null, pendingHatch: null };
-      continue;
-    }
-    const mon = next.active;
-    if (mon.everstone)
-      break;
-    const needed = phaseThreshold(mon.rarity, mon.plannedPath.length, mon.stageIndex);
-    if (mon.usedAtStage < needed)
-      break;
-    const excess = mon.usedAtStage - needed;
-    if (mon.dittoDisguise !== null && !mon.dittoRevealed) {
-      if (next.pendingReveal === null)
-        break;
-      const reveal = next.pendingReveal;
-      events.push({
-        kind: "revealed",
-        disguisedAs: mon.plannedPath[mon.stageIndex] ?? mon.baseId,
-        speciesId: reveal.path[0]
-      });
-      next = {
-        ...next,
-        active: {
-          ...mon,
-          baseId: reveal.path[0],
-          plannedPath: reveal.path,
-          stageIndex: 0,
-          usedAtStage: excess,
-          rarity: reveal.rarity,
-          dittoRevealed: true
-        },
-        pendingReveal: null
-      };
-      continue;
+  return null;
+}
+function loadChain(deps, chainId, cache) {
+  const inFlight = cache.get(chainId);
+  if (inFlight !== undefined)
+    return inFlight;
+  const pending = (async () => {
+    const path = chainPath(chainId);
+    const cached = await readJson(deps, path);
+    if (cached !== null) {
+      const parsed2 = parseChainNode(cached);
+      if (parsed2 !== null)
+        return parsed2;
     }
-    if (mon.stageIndex < mon.plannedPath.length - 1) {
-      events.push({
-        kind: "evolved",
-        from: mon.plannedPath[mon.stageIndex],
-        to: mon.plannedPath[mon.stageIndex + 1]
-      });
-      next = { ...next, active: { ...mon, stageIndex: mon.stageIndex + 1, usedAtStage: excess } };
+    const fetched = await fetchJson(deps, `${POKEAPI_ORIGIN}/api/v2/evolution-chain/${chainId}`);
+    if (fetched === null)
+      return null;
+    const root = asRecord(fetched)?.chain;
+    const parsed = parseChainNode(root);
+    if (parsed === null)
+      return null;
+    await writeJson(deps, path, { chain: root });
+    return parsed;
+  })();
+  cache.set(chainId, pending);
+  return pending;
+}
+function parseNames(raw) {
+  const names = {};
+  for (const entry of asArray(raw) ?? []) {
+    const record = asRecord(entry);
+    if (record === null)
       continue;
-    }
-    events.push({
-      kind: "graduated",
-      baseId: mon.baseId,
-      finalId: mon.plannedPath[mon.plannedPath.length - 1],
-      chainOrder: mon.plannedPath,
-      rarity: mon.rarity,
-      isShiny: mon.isShiny,
-      nature: mon.nature
-    });
-    next = { ...next, active: null, eggUsage: excess, eggTier: null, pendingHatch: null };
+    const language = asRecord(record.language)?.name;
+    const name = record.name;
+    if (typeof language === "string" && typeof name === "string")
+      names[language] = name;
   }
-  return { state: next, events };
+  return names;
 }
-
-// src/store.ts
-var MIGRATIONS = [
-  {
-    version: 1,
-    sql: `
-      CREATE TABLE {{companion}} (
-        api_key_id   TEXT PRIMARY KEY,
-        state        TEXT NOT NULL,
-        tokens_total INTEGER NOT NULL DEFAULT 0,
-        tokens_spent INTEGER NOT NULL DEFAULT 0,
-        created_at   INTEGER NOT NULL,
-        updated_at   INTEGER NOT NULL
-      )
-    `
-  },
-  {
-    version: 2,
-    sql: `
-      CREATE TABLE {{dex}} (
-        id          TEXT PRIMARY KEY,
-        api_key_id  TEXT NOT NULL,
-        base_id     INTEGER NOT NULL,
-        final_id    INTEGER NOT NULL,
-        chain_order TEXT NOT NULL,
-        rarity      TEXT NOT NULL,
-        is_shiny    INTEGER NOT NULL DEFAULT 0,
-        nature      TEXT,
-        caught_at   INTEGER NOT NULL
-      )
-    `
-  },
-  {
-    version: 3,
-    sql: `CREATE INDEX {{dex_by_key}} ON {{dex}} (api_key_id, caught_at DESC)`
-  },
-  {
-    version: 4,
-    sql: `
-      CREATE TABLE {{grants}} (
-        api_key_id TEXT NOT NULL,
-        window_key TEXT NOT NULL,
-        -- An instant, not a tier. A grant is rate-limited by the window's own
-        -- duration, because nothing tells this plugin when a window empties.
-        granted_at INTEGER NOT NULL,
-        PRIMARY KEY (api_key_id, window_key)
-      )
-    `
-  },
-  {
-    version: 5,
-    sql: `ALTER TABLE {{companion}} ADD COLUMN last_credit_at INTEGER`
+function parseCachedDetail(raw, id) {
+  const record = asRecord(raw);
+  if (record === null)
+    return null;
+  const captureRate = asFiniteNumber(record.captureRate);
+  if (captureRate === null)
+    return null;
+  const chainRaw = asArray(record.chain);
+  if (chainRaw === null || chainRaw.length === 0)
+    return null;
+  const chain = [];
+  for (const entry of chainRaw) {
+    if (typeof entry !== "number" || !isFetchableSpeciesId(entry))
+      return null;
+    chain.push(entry);
   }
-];
-function wallet(row) {
-  return Math.max(0, row.tokensTotal - row.tokensSpent);
+  return {
+    id,
+    names: parseNames(record.names),
+    captureRate,
+    isLegendary: record.isLegendary === true,
+    isMythical: record.isMythical === true,
+    chain
+  };
 }
-function readCompanion(storage, apiKeyId) {
-  const row = storage.get(`SELECT api_key_id, state, tokens_total, tokens_spent, last_credit_at
-     FROM {{companion}} WHERE api_key_id = ?`, [apiKeyId]);
-  if (row === null)
-    return null;
+function detailToCache(detail) {
   return {
-    apiKeyId: row.api_key_id,
-    state: parseState(row.state),
-    tokensTotal: row.tokens_total,
-    tokensSpent: row.tokens_spent,
-    lastCreditAt: row.last_credit_at
+    captureRate: detail.captureRate,
+    isLegendary: detail.isLegendary,
+    isMythical: detail.isMythical,
+    chain: detail.chain,
+    names: Object.entries(detail.names).map(([language, name]) => ({
+      language: { name: language },
+      name
+    }))
   };
 }
-function listCompanions(storage) {
-  const rows = storage.all(`SELECT api_key_id, state, tokens_total, tokens_spent, last_credit_at
-     FROM {{companion}}
-     ORDER BY last_credit_at IS NULL, last_credit_at DESC, tokens_total DESC, api_key_id ASC`);
-  return rows.map((row) => ({
-    apiKeyId: row.api_key_id,
-    state: parseState(row.state),
-    tokensTotal: row.tokens_total,
-    tokensSpent: row.tokens_spent,
-    lastCreditAt: row.last_credit_at
-  }));
+async function loadDetail(deps, id, chains) {
+  if (!isFetchableSpeciesId(id))
+    return null;
+  const path = speciesPath(id);
+  const cached = parseCachedDetail(await readJson(deps, path), id);
+  if (cached !== null)
+    return cached;
+  const raw = asRecord(await fetchJson(deps, `${POKEAPI_ORIGIN}/api/v2/pokemon-species/${id}`));
+  if (raw === null)
+    return null;
+  const captureRate = asFiniteNumber(raw.capture_rate);
+  if (captureRate === null)
+    return null;
+  const chainId = chainIdFromUrl(asRecord(raw.evolution_chain)?.url);
+  if (chainId === null)
+    return null;
+  const root = await loadChain(deps, chainId, chains);
+  if (root === null)
+    return null;
+  const chain = lineThrough(root, id);
+  if (chain === null || chain.length === 0)
+    return null;
+  const detail = {
+    id,
+    names: parseNames(raw.names),
+    captureRate,
+    isLegendary: raw.is_legendary === true,
+    isMythical: raw.is_mythical === true,
+    chain
+  };
+  await writeJson(deps, path, detailToCache(detail));
+  return detail;
 }
-function creditTokens(storage, apiKeyId, tokens, now) {
-  if (tokens <= 0)
-    return;
-  storage.run(`INSERT INTO {{companion}} (api_key_id, state, tokens_total, tokens_spent, created_at, updated_at, last_credit_at)
-     VALUES (?, ?, ?, 0, ?, ?, ?)
-     ON CONFLICT(api_key_id) DO UPDATE SET
-       tokens_total = tokens_total + excluded.tokens_total,
-       updated_at = excluded.updated_at,
-       last_credit_at = excluded.last_credit_at`, [apiKeyId, serialiseState(freshState()), Math.trunc(tokens), now, now, now]);
+function speciesDetail(deps, id) {
+  return loadDetail(deps, id, new Map);
 }
-function settle(storage, apiKeyId, now) {
-  const row = readCompanion(storage, apiKeyId);
-  if (row === null)
+function speciesDetails(deps, ids) {
+  const chains = new Map;
+  return Promise.all(ids.map((id) => loadDetail(deps, id, chains)));
+}
+async function cachedSpeciesName(deps, id) {
+  if (!isFetchableSpeciesId(id))
     return null;
-  if (row.state === null)
-    return { row, events: [] };
-  const result = advance(row.state, row.tokensTotal);
-  if (result.events.length === 0 && result.state === row.state)
-    return { row, events: [] };
-  storage.run("UPDATE {{companion}} SET state = ?, updated_at = ? WHERE api_key_id = ?", [
-    serialiseState(result.state),
-    now,
-    apiKeyId
-  ]);
-  return { row: { ...row, state: result.state }, events: result.events };
+  const cached = parseCachedDetail(await readJson(deps, speciesPath(id)), id);
+  return cached?.names.en ?? null;
 }
-function recordGraduation(storage, apiKeyId, entry, id) {
-  storage.run(`INSERT INTO {{dex}} (id, api_key_id, base_id, final_id, chain_order, rarity, is_shiny, nature, caught_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
-    id,
-    apiKeyId,
-    entry.baseId,
-    entry.finalId,
-    JSON.stringify(entry.chainOrder),
-    entry.rarity,
-    entry.isShiny ? 1 : 0,
-    entry.nature,
-    entry.caughtAt
-  ]);
+function parseCachedIndex(raw) {
+  const entries = asArray(raw);
+  if (entries === null)
+    return null;
+  const candidates = [];
+  for (const entry of entries) {
+    const record = asRecord(entry);
+    if (record === null)
+      return null;
+    const id = asFiniteNumber(record.id);
+    const captureRate = asFiniteNumber(record.captureRate);
+    const forms = asFiniteNumber(record.forms);
+    const finalId = asFiniteNumber(record.finalId);
+    if (id === null || captureRate === null || forms === null || finalId === null)
+      return null;
+    if (!isFetchableSpeciesId(id))
+      return null;
+    candidates.push({ id, captureRate, forms, finalId });
+  }
+  return candidates.length === 0 ? null : candidates;
 }
-function readDex(storage, apiKeyId) {
-  const rows = storage.all(`SELECT id, base_id, final_id, chain_order, rarity, is_shiny, nature, caught_at
-     FROM {{dex}} WHERE api_key_id = ? ORDER BY caught_at DESC`, [apiKeyId]);
-  const entries = [];
-  for (const row of rows) {
-    let chainOrder;
-    try {
-      chainOrder = JSON.parse(row.chain_order);
-    } catch {
-      continue;
+async function mapWithConcurrency(ids, limit, worker) {
+  const results = new Array(ids.length);
+  let next = 0;
+  const runners = Array.from({ length: Math.min(limit, ids.length) }, async () => {
+    while (next < ids.length) {
+      const index = next++;
+      results[index] = await worker(ids[index]);
     }
-    if (!Array.isArray(chainOrder))
+  });
+  await Promise.all(runners);
+  return results;
+}
+async function speciesIndex(deps) {
+  const cached = parseCachedIndex(await readJson(deps, INDEX_PATH));
+  if (cached !== null)
+    return cached;
+  const ids = Array.from({ length: ANIMATED_SPECIES_MAX }, (_, i) => i + 1);
+  const chains = new Map;
+  const details = await mapWithConcurrency(ids, INDEX_FETCH_CONCURRENCY, (id) => loadDetail(deps, id, chains));
+  const candidates = [];
+  for (const detail of details) {
+    if (detail === null)
       continue;
-    const chain = chainOrder.filter((id) => typeof id === "number");
-    if (chain.length === 0)
+    if (detail.chain[0] !== detail.id)
       continue;
-    entries.push({
-      id: row.id,
-      baseId: row.base_id,
-      finalId: row.final_id,
-      chainOrder: chain,
-      rarity: row.rarity,
-      isShiny: row.is_shiny === 1,
-      nature: row.nature,
-      caughtAt: row.caught_at
+    candidates.push({
+      id: detail.id,
+      captureRate: detail.captureRate,
+      forms: detail.chain.length,
+      finalId: detail.chain[detail.chain.length - 1] ?? detail.id
     });
   }
-  return entries;
-}
-function lastGrantedAt(storage, apiKeyId, windowKey2) {
-  const row = storage.get("SELECT granted_at FROM {{grants}} WHERE api_key_id = ? AND window_key = ?", [apiKeyId, windowKey2]);
-  return row?.granted_at ?? null;
-}
-function setGrantedAt(storage, apiKeyId, windowKey2, at) {
-  storage.run(`INSERT INTO {{grants}} (api_key_id, window_key, granted_at) VALUES (?, ?, ?)
-     ON CONFLICT(api_key_id, window_key) DO UPDATE SET granted_at = excluded.granted_at`, [apiKeyId, windowKey2, at]);
-}
-function shopPrice(entry) {
-  return entry.kind === "item" ? ITEM_PRICES[entry.item] : freshEggPrice(entry.tier);
+  if (details.every((detail) => detail !== null))
+    await writeJson(deps, INDEX_PATH, candidates);
+  return candidates;
 }
-function consume(storage, apiKeyId, item, applyToState, now) {
-  const row = readCompanion(storage, apiKeyId);
-  if (row === null)
-    return { ok: false, reason: "missing" };
-  if (row.state === null)
-    return { ok: false, reason: "unreadable" };
-  if ((row.state.inventory[item] ?? 0) <= 0)
-    return { ok: false, reason: "none-held" };
-  const outcome = applyToState(row.state);
-  if ("refused" in outcome)
-    return { ok: false, reason: outcome.refused };
-  const nextState = {
-    ...outcome.applied,
-    inventory: {
-      ...outcome.applied.inventory,
-      [item]: (outcome.applied.inventory[item] ?? 0) - 1
-    }
-  };
-  storage.run("UPDATE {{companion}} SET state = ?, updated_at = ? WHERE api_key_id = ?", [
-    serialiseState(nextState),
-    now,
-    apiKeyId
-  ]);
-  return { ok: true, row: { ...row, state: nextState } };
+async function spriteBytes(deps, id, shiny) {
+  if (!isFetchableSpeciesId(id))
+    return null;
+  const path = spritePath(id, shiny);
+  try {
+    const cached = await deps.files.read(path);
+    if (cached !== null && cached.length > 0)
+      return cached;
+  } catch {}
+  const url = shiny ? `${SPRITE_ORIGIN}${SPRITE_DIR}/shiny/${id}.gif` : `${SPRITE_ORIGIN}${SPRITE_DIR}/${id}.gif`;
+  const bytes = await fetchBytes(deps, url);
+  if (bytes === null)
+    return null;
+  await writeCache(deps, path, bytes);
+  return bytes;
 }
-function purchase(storage, apiKeyId, entry, applyToState, now) {
-  const price = shopPrice(entry);
-  {
-    const row = readCompanion(storage, apiKeyId);
-    if (row === null)
-      return { ok: false, reason: "missing" };
-    if (row.state === null)
-      return { ok: false, reason: "unreadable" };
-    if (wallet(row) < price)
-      return { ok: false, reason: "insufficient" };
-    const outcome = applyToState(row.state);
-    if ("refused" in outcome)
-      return { ok: false, reason: outcome.refused };
-    const nextState = outcome.applied;
-    storage.run("UPDATE {{companion}} SET state = ?, tokens_spent = tokens_spent + ?, updated_at = ? WHERE api_key_id = ?", [serialiseState(nextState), price, now, apiKeyId]);
-    return {
-      ok: true,
-      row: { ...row, state: nextState, tokensSpent: row.tokensSpent + price }
-    };
-  }
+async function itemSpriteBytes(deps, item) {
+  const name = ITEM_SPRITE_NAMES.get(item);
+  if (name === undefined)
+    return null;
+  const path = itemSpritePath(name);
+  try {
+    const cached = await deps.files.read(path);
+    if (cached !== null && cached.length > 0)
+      return cached;
+  } catch {}
+  const bytes = await fetchBytes(deps, `${SPRITE_ORIGIN}${ITEM_SPRITE_DIR}/${name}.png`);
+  if (bytes === null)
+    return null;
+  await writeCache(deps, path, bytes);
+  return bytes;
 }
 
 // src/server.ts
@@ -1077,6 +1262,17 @@ var server_default = definePlugin({
       const result = settle(storage, apiKeyId, ctx.now());
       if (result === null)
         return;
+      const active = result.row.state?.active;
+      if (active !== null && active !== undefined) {
+        recordSightings(storage, apiKeyId, {
+          plannedPath: active.plannedPath,
+          stageIndex: active.stageIndex,
+          stageTimes: active.stageTimes,
+          rarity: active.rarity,
+          isShiny: active.isShiny,
+          disguised: active.dittoDisguise !== null && !active.dittoRevealed
+        }, ctx.now());
+      }
       for (const event of result.events) {
         if (event.kind !== "graduated")
           continue;
@@ -1084,6 +1280,7 @@ var server_default = definePlugin({
           baseId: event.baseId,
           finalId: event.finalId,
           chainOrder: event.chainOrder,
+          stageTimes: event.stageTimes,
           rarity: event.rarity,
           isShiny: event.isShiny,
           nature: event.nature,
@@ -1253,13 +1450,15 @@ var server_default = definePlugin({
           if (row.state !== null)
             prefetchOnce(apiKeyId, row.state).catch(() => {});
           const active = row.state?.active ?? null;
-          const dex = readDex(storage, apiKeyId);
           const stageId = active === null ? null : active.plannedPath[active.stageIndex] ?? null;
           const stageName = await nameOf(stageId);
-          const named = await Promise.all(dex.map(async (entry) => ({ ...entry, name: await nameOf(entry.finalId) })));
+          const named = await Promise.all(readCollection(storage, apiKeyId).map(async (record) => ({
+            ...record,
+            name: await nameOf(record.speciesId)
+          })));
           warmNames([
             ...stageId !== null && stageName === null ? [stageId] : [],
-            ...named.filter((entry) => entry.name === null).map((entry) => entry.finalId)
+            ...named.filter((record) => record.name === null).map((record) => record.speciesId)
           ]);
           return {
             json: {