# The Card Vault connector (`thecardvault`)

- Source: https://thecardvault.co.uk · Glasgow hobby store: TCG singles (BinderPOS-style "Name (number)" titles with Foil / condition variants), sealed Pokémon/MTG/Yu-Gi-Oh!/One Piece/Lorcana, Panini & Topps sports boxes, Funko, Youtooz, Iron Studios statues, Nendoroids and Gunpla.
- Country/currency: GB / GBP · 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 (17): `singles-all-card-games` (rules decide), `pokemon-tcg-all-products` → pokemon, `magic-the-gathering-all-products` → magic_the_gathering, `sealed-yu-gi-oh-products` → yugioh, `one-piece-tcg-all-products` → one_piece_card_game, `disney-lorcana-all-products` → disney_lorcana, `dragon-ball-super-cg-all-products` → dragon_ball_tcg, `digimon-trading-card-game` → digimon_tcg, `weiss-schwarz-all-products` → weiss_schwarz, `star-wars-unlimited-all-products` → star_wars_tcg, `final-fantasy-tcg-all-products` → final_fantasy_tcg, `sports-cards-all-products` → other_sports_cards, `funko-pop-vinyl-figures` → funko, `youtooz-collectable-vinyl-figures` → designer_toys, `iron-studios-scale-statue` → action_figures, `good-smile-company-nendoroid-figures` → action_figures, `bandai-gunpla` → gundam.

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