# Gameology connector (`gameology`)

- Source: https://www.gameology.com.au · Melbourne online game store: 22k TCG singles (MTG, Pokémon English/Japanese, One Piece, Lorcana, Yu-Gi-Oh!), PSA-graded cards, Funko Pop!, statues & anime figures, Topps/Panini sports cards. Tags carry Number_/Printing_/Set_ attributes.
- Country/currency: AU / AUD · 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, and the shop currency. Anything unmapped is skipped, never guessed.

Collections read (17): `magic-the-gathering-singles` → magic_the_gathering, `pokemon-tcg-single-cards` → pokemon, `japanese-pokemon-singles` → pokemon, `pokemon-collection` → pokemon, `one-piece-tcg-single-cards` → one_piece_card_game, `lorcana-tcg-singles` → disney_lorcana, `yugioh` → yugioh, `weiss-schwarz` → weiss_schwarz, `digimon-card-game` → digimon_tcg, `star-wars-unlimited` → star_wars_tcg, `flesh-and-blood-tcg` → flesh_and_blood, `dragon-ball-super` → dragon_ball_tcg, `graded-card` → other_tcg, `pop-vinyl-figures` → funko, `statues-figures` → action_figures, `sports-collectables` → other_sports_cards, `topps-sports-cards` → other_sports_cards.

## 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/gameology/*.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 gameology`.