# Solaris Japan connector (`solarisjapan`)

- Source: https://solarisjapan.com · Anime figure and Japanese retro-game store (US-registered, ships from Japan): 70k figures (Nendoroid, figma, Pop Up Parade, prize figures, Revoltech), pre-owned and brand-new variants with separate prices, Japanese retro games (Famicom/Super Famicom, PS1, Mega Drive, DS/3DS/Switch) and Japanese One Piece/Pokémon TCG products. Adult (nsfw-tagged) figures are excluded.
- Country/currency: US / USD · 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 24 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 (16): `figures` → action_figures, `nendoroid` → action_figures, `figma` → action_figures, `pop-up-parade-figures` → action_figures, `prize-figures` → action_figures, `revoltech-figures` → action_figures, `marvel-dc-action-figures` → action_figures, `star-wars-figures` → action_figures, `gundam-figures` → gundam, `retro-games` → video_games, `nintendo-ds` → nintendo_games, `nintendo-3ds` → nintendo_games, `nintendo-switch` → nintendo_games, `one-piece-tcg` → one_piece_card_game, `pokemon-tcg` → pokemon, `plushies` → plush.

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