# Flagship Games connector (`flagshipgames`)

- Source: https://www.flagshipgames.sg · Singapore MTG specialist on BinderPOS: singles for most Magic sets back to Ice Age/Fourth Edition, Mystery Booster playtest cards, Final Fantasy and Marvel Universes Beyond, plus English and Japanese Pokémon singles, sealed MTG, One Piece and Lorcana.
- Country/currency: SG / SGD · type: dealer · engine: api (Shopify storefront products.json (public JSON))
- Records: `listing` only (dealer asking prices; never sales — SPEC §111). One listing per variant (condition / size / finish), out-of-stock variants kept as `ended`.
- Refresh: every 12 h (NORMAL class) · historical depth: none (no sold archive).

## How it works
Metadata-only connector: `index.ts` instantiates the shared `ShopifyStoreConnector` adapter; everything source-specific lives in `meta.json` `config`:
collections → taxonomy slug (with brand/franchise/series), title/tag `rules` (first match wins), an `exclude` regex for accessories/apparel/events, a `titlePattern` that extracts name/set/number, and the shop currency. Anything unmapped is skipped, never guessed.

Collections read (22): `english-pokemon-1` → pokemon, `japanese-pokemon-1` → pokemon, `pokemon-25th-anniversary-celebrations` → pokemon, `mystery-booster` → magic_the_gathering, `final-fantasy` (rules decide), `final-fantasy-commander` → magic_the_gathering, `marvel-super-heroes-commander` → magic_the_gathering, `foundations` → magic_the_gathering, `aetherdrift` → magic_the_gathering, `edge-of-eternities` → magic_the_gathering, `lorwyn-eclipsed` → magic_the_gathering, `bloomburrow` → magic_the_gathering, `duskmourn-house-of-horror` → magic_the_gathering, `modern-horizons-3` → magic_the_gathering, `commander-masters` → magic_the_gathering, `avatar-the-last-airbender` → magic_the_gathering, `ice-age` → magic_the_gathering, `fourth-edition` → magic_the_gathering, `alpha-limited-edition` → magic_the_gathering, `mtg-sealed-products` → magic_the_gathering, `one-piece-card-game` → one_piece_card_game, `lorcana-sealed-products` → disney_lorcana.

## Access & compliance
See `accessNotes` in meta.json (robots findings, endpoints, rate limit, what is not fetched). Host policy: `connectors/domains.d/g4-shops-intl.json`.

## Fixtures & tests
`data/fixtures/flagshipgames/*.json` are live captures made with `connectors/api/_g4-shops-intl-lib/capture.ts` (trimmed payloads, expectations derived from the live record). `index.test.ts` runs the framework fixture suite, the g4 store invariants and a mapping unit test on titles observed live. Live probe: `pnpm tsx connectors/api/_g4-shops-intl-lib/smoke.ts flagshipgames`.