Class CartSessionClient

The current bound session id (after create()/resume()), or null.

Hand off to hosted/embedded checkout. Marks the session converted (no more edits).

Create a new cart session and bind this client to it.

Read the current session + cart snapshot.

The Throttle-hosted cart page for this session. Send a buyer here to let Throttle run the cart UI instead of building one.

Bind to an existing session id — e.g. one restored from localStorage.

Unit count + total for a cart badge, without pulling the whole cart.

Works on a client built with CartSessionClient.forSession — a storefront that restored a cart_… id from localStorage and holds no publishable token in the browser.

Set buyer-editable cart fields. Pass null to clear one.

Bind to an existing session without a publishable token.

create() needs a quote token; every other route is authorized by the opaque cart_… id alone. A caller that only ever resumes — Throttle's own hosted cart page, or a storefront restoring from localStorage — would otherwise have to invent a token to satisfy the constructor.