[pronob1010]

A chat bubble on the storefront: the example for any app shoppers talk to (support bot, gift finder, AI assistant).

What it does

• "green tea under 20" → product cards with Add to cart and View.
• "where's my order?" → a guest is asked to sign in; a signed-in customer sees their last 3 orders, and only theirs.
• Add to cart goes through the store's own cart.add, so the cart and drawer update, the store announces the change with Undo, and its limits apply.

How

Part	Uses
storefront/assistant.js	A storefront script in a shadow root: window.FlyCommerce.shopperToken() for each question, run('cart.add' | 'nav.goto' | 'ui.openCart'); elements built with textContent only
src/chat.ts	allowStorefrontCalls() + authenticateShopper(): the store and customer come only from the verified token
src/search.ts	GET /api/v1/search/products (catalog.read), then the price limit parsed from the question
src/orders.ts	GET /api/v1/orders?filters[customerId]= (orders.read) for the token's customer
src/dev.ts	The emulator: teas and mugs, one customer's orders and another's, and the example store page with a guest or signed-in shopper

No AI key: replies come from rules in reply(). The README and AGENTS.md show where a language model goes, with search and orders as its tools and the cart left to the shopper's click.

Without storefront.customer it still searches, and tells a signed-in shopper their orders are on their account page.

Depends on

The SDK's 0.1.0-next.4: authenticateShopper, allowStorefrontCalls, and the emulator's products, shopper tokens and store actions (getdokan/flycommerce-sdk#22). Merge after that's published.

Tests

• test/chat.test.ts (8, against the emulator):
  • parsing words and a price;
  • search within a price;
  • nothing found;
  • only the signed-in customer's orders;
  • guest asked to sign in;
  • no storefront.customer;
  • missing or forged token refused, with CORS;
  • the bubble served with its App ID.
• prettier --check and tsc are clean.
• Checked in a browser with npm run dev:
  • as a guest, "green tea under 20" listed the teas and mugs under 20, leaving out the 24 teapot;
  • Add to cart showed the store's notice and Undo, and the cart count went to 1;
  • "where's my order?" asked a guest to sign in;
  • switched to signed in, it listed customer 1001's two orders and not the other customer's.