# shop
## In-page layer
JS helpers injected into the page: product cards, cart lines, form
fields, blockers.
## Site hints
Known cart/search URL patterns per host. Unknown sites fall back to
generic selectors.
------------------------------------------------------------------------
source
### site_hint
``` python
def site_hint(
url:str
)->dict:
```
*Hints
([`search`](https://vedicreader.github.io/fossick/cli.html#search),
`cart`, `note`) for the host of `url`; `{}` when the site is not
listed.*
## Reading
`products`, `lines`, `fields`, `blockers`, structured views of what the
page exposes.
------------------------------------------------------------------------
source
### Page.shop_dismiss
``` python
async def shop_dismiss(
page:Page
)->list:
```
*Click through cookie/consent banners and closable modals. Returns the
labels it clicked.*
------------------------------------------------------------------------
source
### Page.shop_blockers
``` python
async def shop_blockers(
page:Page
)->list:
```
*What is standing in the way: `cookie-banner`, `location-required`,
`login-required`, `captcha`, `modal-open`.*
------------------------------------------------------------------------
source
### Page.shop_lines
``` python
async def shop_lines(
page:Page
)->list:
```
*Cart line items read from the page: `[{i, text, price, qty, remove}]`.
Run this on the cart page.*
------------------------------------------------------------------------
source
### Page.shop_cart
``` python
async def shop_cart(
page:Page, lines:bool=False
)->dict:
```
*Current cart: `{count, subtotal, source}` (+ `lines` if asked). Uses
Shopify’s `/cart.js` when available.*
------------------------------------------------------------------------
source
### Page.shop_products
``` python
async def shop_products(
page:Page, limit:int=40
)->list:
```
*Products on the current page as
`[{i, title, price, url, add, qty, oos, vid}]`. `i` feeds
[`shop_add`](https://vedicreader.github.io/fossick/mcp.html#shop_add).*
------------------------------------------------------------------------
source
### Page.shop_prep
``` python
async def shop_prep(
page:Page, force:bool=False
)->str:
```
*The platform this store runs on — `shopify`, `woocommerce`,
`bigcommerce`, `magento`, `next`* or `generic` — injecting the in-page
helpers first if the page has none (a navigation wipes them).
------------------------------------------------------------------------
source
### ShopError
``` python
def ShopError(
*args, **kwargs
):
```
*A shop action could not be carried out (bad index, no add control,
nothing to match).*
## Verified actions
Add/fill/submit only count when the page state changes in an expected
signal.
------------------------------------------------------------------------
source
### Page.shop_add
``` python
async def shop_add(
page:Page, item, qty:int=1, variant:str=None, open_product:bool=True, tout:int=12
)->dict:
```
*Add `item` (index from
[`shop_products`](https://vedicreader.github.io/fossick/mcp.html#shop_products),
or a title) to the cart and verify it landed.*
Returns `{ok, item, how, before, after}`. `ok=True` only when a cart
signal actually moved; `ok=None` means the site exposes no signal to
check, and `ok=False` means nothing changed. On a Shopify site this
posts to `/cart/add.js`, which needs no clicking and no guessing.
------------------------------------------------------------------------
source
### Page.shop_remove
``` python
async def shop_remove(
page:Page, line, tout:int=12
)->dict:
```
*Remove cart line `line`. Verified the same way as
[`shop_add`](https://vedicreader.github.io/fossick/mcp.html#shop_add).*
------------------------------------------------------------------------
source
### Page.shop_qty
``` python
async def shop_qty(
page:Page, line, qty:int, tout:int=12
)->dict:
```
*Set the quantity of cart line `line` (index from `shop_lines`, or a
Shopify line key). Verified.*
------------------------------------------------------------------------
source
### Page.shop_cart_page
``` python
async def shop_cart_page(
page:Page, url:str=None
)->dict:
```
*Open the cart page (hint, on-page cart link, then `/cart`) and return
the cart with its lines.*
## Checkout forms
`fields()` maps visible inputs (incl. AU wording / autocomplete).
Payment fields are guarded.
------------------------------------------------------------------------
source
### match_fields
``` python
def match_fields(
fields:list, profile:dict
)->dict:
```
*Best field for each profile key: `{key: field}`. One field per key,
highest score wins.*
------------------------------------------------------------------------
source
### Page.shop_fill
``` python
async def shop_fill(
page:Page, profile:dict, submit:str=None, confirm:bool=False
)->dict:
```
*Fill a checkout form from a profile dict, then re-read the form to
confirm what stuck.*
Keys are canonical
(`first_name, last_name, email, phone, address1, address2, city, state, postcode, country, company, notes, card_*`)
and are matched to fields by `autocomplete` token first; a numeric key
sets that
[`shop_fields`](https://vedicreader.github.io/fossick/mcp.html#shop_fields)
index directly, for the options a profile has no name for (size, colour,
delivery window). Returns `{filled, failed, unmatched, fields}`.
`submit=` clicks that button by name; a payment-looking button
additionally needs `confirm=True`.
------------------------------------------------------------------------
source
### Page.shop_set
``` python
async def shop_set(
page:Page, i:int, value
)->dict:
```
*Set form field `i` (index from
[`shop_fields`](https://vedicreader.github.io/fossick/mcp.html#shop_fields))
to `value`; returns what the field holds afterwards.*
------------------------------------------------------------------------
source
### Page.shop_fields
``` python
async def shop_fields(
page:Page
)->list:
```
*Every visible form field with its label, `autocomplete` token, value
and `