# Cherry Collectables connector (`cherrycollectables`)

- Source: https://www.cherrycollectables.com.au · Australia's largest card shop (Melbourne; official Panini NBA distributor): ~390k singles across NBA/NFL/soccer/MLB/NHL/AFL/UFC/F1 sports cards, Pokémon (incl. PSA/CGC/BGS graded slabs), Yu-Gi-Oh!, MTG, One Piece, Digimon, Flesh and Blood, plus sealed boxes. Group breaks are excluded.
- 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 (21): `pokemon-singles` → pokemon, `graded-pkm` → pokemon, `psa-10` → pokemon, `pokemon-booster-boxes` → pokemon, `magic-the-gathering-singles` → magic_the_gathering, `ygo-singles` → yugioh, `one-piece-singles` → one_piece_card_game, `digimon-singles` → digimon_tcg, `flesh-and-blood-singles` → flesh_and_blood, `lorcana` → disney_lorcana, `nba-singles` → basketball_cards, `graded-nba-cards` → basketball_cards, `nfl-singles` → football_cards, `soccer-singles` → soccer_cards, `mlb-singles` → baseball_cards, `nhl-singles` → hockey_cards, `all-f1` → f1_cards, `afl-singles` → other_sports_cards, `ufc-singles` → other_sports_cards, `wrestling-singles` → other_sports_cards, `marvel-singles` → non_sport_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/cherrycollectables/*.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 cherrycollectables`.