@wix/agent-skills 1.16.3 → 1.18.0

package/skills/wix-vibe-headless/references/rentals/INSTRUCTIONS.md

@@ -0,0 +1,13 @@
+---
+name: rentals
+description: Rentals — renting out an item for a length the customer picks. Runs on the Bookings vertical.
+---
+
+# Rentals
+
+Rentals is **the Bookings vertical** — Wix Rentals runs on the Bookings APIs. There is nothing
+separate to build here.
+
+Read and follow `.agents/skills/wix-vibe-headless/references/bookings/INSTRUCTIONS.md` (its
+**Rentals** section), and use the bookings scaffolds under `references/bookings/app/`. The install
+already deploys those for you when `rentals` is selected.

package/skills/wix-vibe-headless/references/restaurants/INSTRUCTIONS.md

@@ -170,6 +170,8 @@ render.
 
 ## Using the client from your own UI (menu, order cart)
 
+> Migrating from Cart V1 / Checkout V1? These helpers are V2-only — see the [migration guide](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/migration-guide) for the before/after.
+
 ```jsx
 import { getFullMenu } from "@/rest/wix-restaurants-menu";
 import { useOrderCart } from "@/context/OrderCartContext";
@@ -188,7 +190,8 @@ const { menus } = await getFullMenu();            // [] when no menus → show t
 // Load-bearing field paths (the shipped components already do these):
 // - item.image / section.image / label.icon are OBJECTS → render `.url`, never the object; //-urls → https:
 // - MENU prices are plain decimal strings with NO currency symbol ("12.50") — format in the UI.
-//   The eCom cart line price (line.price.formattedAmount) DOES include the symbol.
+//   The eCom cart line price (line.pricing.unitPrice / line.pricing.totalPrice) is a ConvertedMoney
+//   { amount, convertedAmount } with NO symbol either — format the number yourself.
 // - an item is priced by EITHER item.price (single) OR item.variants[] (one-of, each { name, price }).
 // - a cart mutation uses cart.lineItems[].id (the lineItemId), NOT the menu item id.
 ```

package/skills/wix-vibe-headless/references/restaurants/app/components/OrderCartDrawer.jsx

@@ -1,9 +1,18 @@
 // Slide-over order cart. Reads everything from useOrderCart(); mutate by lineItem.id (NOT the menu
-// item id), check out via the context (redirect-session URL). The eCom cart price
-// (line.price.formattedAmount) DOES include the currency symbol, unlike menu prices. Styled with
-// base44 design tokens (shadcn Tailwind classes). Mount it once in the Layout.
+// item id), check out via the context (redirect-session URL). The eCom Cart V2 line price is
+// `pricing.totalPrice`, a ConvertedMoney { amount, convertedAmount } with NO formatted string —
+// format it with the cart's currency (formatCartMoney below). Styled with base44 design tokens
+// (shadcn Tailwind classes). Mount it once in the Layout.
 import { useOrderCart } from "@/context/OrderCartContext";
 
+// Cart V2 money is a ConvertedMoney { amount, convertedAmount } with NO formatted string — format it
+// with the cart's currency (buyer's display currency when present, else the site currency).
+function formatCartMoney(money, cart) {
+  const value = money?.convertedAmount ?? money?.amount;
+  const currency = cart?.customerInfo?.currencyCode ?? cart?.businessInfo?.currencyCode ?? "USD";
+  return value == null ? "" : new Intl.NumberFormat(undefined, { style: "currency", currency }).format(Number(value));
+}
+
 export default function OrderCartDrawer() {
   const { cart, isOpen, setIsOpen, removeItem, updateQuantity, checkout, loading } = useOrderCart();
   const lineItems = cart?.lineItems ?? [];
@@ -22,23 +31,26 @@ export default function OrderCartDrawer() {
         <div className="flex-1 overflow-y-auto p-4">
           {lineItems.length === 0 ? (
             <p className="text-muted-foreground">Your order is empty.</p>
-          ) : lineItems.map((line) => (
+          ) : lineItems.map((line) => {
+            const qty = line.quantityInfo?.confirmedQuantity;
+            return (
             <div key={line.id} className="flex gap-3 py-3 border-b border-border">
               {/* line.id is the lineItemId for mutations — NOT the menu item id */}
               <div className="flex-1 flex flex-col gap-1">
-                <span className="font-semibold">{line.productName?.original}</span>
+                <span className="font-semibold">{line.name?.original}</span>
                 <div className="flex items-center gap-2 mt-1">
-                  <QtyButton onClick={() => updateQuantity(line.id, Math.max(1, line.quantity - 1))}>−</QtyButton>
-                  <span className="min-w-[20px] text-center">{line.quantity}</span>
-                  <QtyButton onClick={() => updateQuantity(line.id, line.quantity + 1)}>+</QtyButton>
+                  <QtyButton onClick={() => updateQuantity(line.id, Math.max(1, qty - 1))}>−</QtyButton>
+                  <span className="min-w-[20px] text-center">{qty}</span>
+                  <QtyButton onClick={() => updateQuantity(line.id, qty + 1)}>+</QtyButton>
                   <button onClick={() => removeItem(line.id)}
                     className="ml-auto border-none bg-transparent cursor-pointer text-muted-foreground text-[13px] underline">Remove</button>
                 </div>
               </div>
-              {/* eCom cart price DOES include the currency symbol (unlike menu prices) */}
-              <span className="font-semibold">{line.price?.formattedAmount}</span>
+              {/* Cart V2 has no formatted string — format the ConvertedMoney client-side */}
+              <span className="font-semibold">{formatCartMoney(line.pricing?.totalPrice, cart)}</span>
             </div>
-          ))}
+            );
+          })}
         </div>
 
         {lineItems.length > 0 && (

package/skills/wix-vibe-headless/references/restaurants/app/context/OrderCartContext.jsx

@@ -30,7 +30,7 @@ export function OrderCartProvider({ children }) {
     return () => document.removeEventListener("visibilitychange", onVisible);
   }, [refreshCart]);
 
-  const itemCount = (cart?.lineItems ?? []).reduce((n, li) => n + (li.quantity || 0), 0);
+  const itemCount = (cart?.lineItems ?? []).reduce((n, li) => n + (li.quantityInfo?.confirmedQuantity || 0), 0);
 
   // A menu item carries its menuId/sectionId from the getFullMenu tree — the caller passes both.
   // addItemToCart throws on a missing operation/menu/section or an unavailable line; let it propagate.

package/skills/wix-vibe-headless/references/restaurants/app/rest/wix-restaurants-ordering.js

@@ -11,15 +11,16 @@ import { wixApiRequest } from "./wix-client.js";
  *   fulfillmentIds {string[]}, businessLocationId {string}
  * Full model: https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/operations/operation-object.md
  *
- * Cart (Wix eCom) — restaurant orders use the same visitor cart as the storefront.
- *   id {string}, currency {string},
+ * Cart (Wix eCom V2) — restaurant orders use the same visitor cart as the storefront.
+ *   id {string} — the cart id IS the checkout id,
  *   lineItems[].id {string} — lineItemId for update/remove (NOT the item id),
- *   lineItems[].quantity {number},
- *   lineItems[].catalogReference.catalogItemId {string} — the ordered item's GUID,
- *   lineItems[].productName.original {string},
- *   lineItems[].price.formattedAmount {string},
- *   lineItems[].availability.status {string} — "AVAILABLE"|"NOT_AVAILABLE"|"PARTIALLY_AVAILABLE"|"NOT_FOUND"
- * Full model: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/cart/cart-object.md
+ *   lineItems[].quantityInfo.confirmedQuantity {number},
+ *   lineItems[].source.catalogReference.catalogItemId {string} — the ordered item's GUID (NOT top-level in V2),
+ *   lineItems[].name.original {string},
+ *   lineItems[].pricing.unitPrice / lineItems[].pricing.totalPrice {ConvertedMoney} —
+ *     { amount, convertedAmount } with NO formatted string; format the number client-side,
+ *   lineItems[].status {string} — "IN_STOCK"|"PARTIALLY_IN_STOCK"|"OUT_OF_STOCK"|"REMOVED_FROM_CATALOG"
+ * Full model: https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/purchase-flow/cart-v2/get-current-cart.md
  */
 
 // Wix Restaurants Orders app id — required in catalogReference when adding menu items to the eCom cart.
@@ -61,7 +62,7 @@ export async function getDefaultOperation() {
  * Confirm the shape before extending:
  * https://dev.wix.com/docs/api-reference/business-solutions/restaurants/online-orders/sample-flows.md
  *
- * POST https://www.wixapis.com/ecom/v1/carts/current/add-to-cart
+ * POST https://www.wixapis.com/ecom/v2/carts/current/add-line-items
  * @param {string} itemId  Menu item GUID (item.id).
  * @param {{ operationId: string, menuId: string, sectionId: string, onlineOrderingPageUrl?: string, quantity?: number }} opts
  * @returns {Promise<object>} Updated cart.
@@ -74,15 +75,16 @@ export async function addItemToCart(itemId, { operationId, menuId, sectionId, on
   const options = { operationId, menuId, sectionId };
   if (onlineOrderingPageUrl) options.onlineOrderingPageUrl = onlineOrderingPageUrl;
 
-  const res = await wixApiRequest("/ecom/v1/carts/current/add-to-cart", {
+  const res = await wixApiRequest("/ecom/v2/carts/current/add-line-items", {
     method: "POST",
     body: {
-      lineItems: [{ catalogReference: { appId: RESTAURANTS_ORDERS_APP_ID, catalogItemId: itemId, options }, quantity }],
+      catalogItems: [{ catalogReference: { appId: RESTAURANTS_ORDERS_APP_ID, catalogItemId: itemId, options }, quantity }],
     },
   });
-  const line = (res?.cart?.lineItems ?? []).find((l) => l.catalogReference?.catalogItemId === itemId);
-  if (line?.availability?.status && line.availability.status !== "AVAILABLE") {
-    throw new Error(`Item not available to order (status: ${line.availability.status}).`);
+  // V2 nests the reference under `source` — a top-level lineItem.catalogReference no longer exists.
+  const line = (res?.cart?.lineItems ?? []).find((l) => l.source?.catalogReference?.catalogItemId === itemId);
+  if (line?.status && line.status !== "IN_STOCK") {
+    throw new Error(`Item not available to order (status: ${line.status}).`);
   }
   return res?.cart;
 }
@@ -90,7 +92,7 @@ export async function addItemToCart(itemId, { operationId, menuId, sectionId, on
 /** Read the visitor's current cart. Returns null if no cart exists yet. */
 export async function getCurrentCart() {
   try {
-    const res = await wixApiRequest("/ecom/v1/carts/current", { method: "GET" });
+    const res = await wixApiRequest("/ecom/v2/carts/current", { method: "GET" });
     return res?.cart ?? null;
   } catch {
     return null;
@@ -99,24 +101,24 @@ export async function getCurrentCart() {
 
 /**
  * Update the quantity of a cart line. lineItemId is cart.lineItems[].id, not the item id.
- * POST https://www.wixapis.com/ecom/v1/carts/current/update-line-items-quantity
+ * POST https://www.wixapis.com/ecom/v2/carts/current/update-line-items
  * @returns {Promise<object>} Updated cart.
  */
 export async function updateCartItemQuantity(lineItemId, quantity) {
-  const res = await wixApiRequest("/ecom/v1/carts/current/update-line-items-quantity", {
+  const res = await wixApiRequest("/ecom/v2/carts/current/update-line-items", {
     method: "POST",
-    body: { lineItems: [{ id: lineItemId, quantity }] },
+    body: { lineItems: [{ lineItemId, quantity: { newQuantity: quantity } }] },
   });
   return res?.cart;
 }
 
 /**
  * Remove a line from the current cart by its cart.lineItems[].id.
- * POST https://www.wixapis.com/ecom/v1/carts/current/remove-line-items
+ * POST https://www.wixapis.com/ecom/v2/carts/current/remove-line-items
  * @returns {Promise<object>} Updated cart.
  */
 export async function removeFromCart(lineItemId) {
-  const res = await wixApiRequest("/ecom/v1/carts/current/remove-line-items", {
+  const res = await wixApiRequest("/ecom/v2/carts/current/remove-line-items", {
     method: "POST",
     body: { lineItemIds: [lineItemId] },
   });
@@ -124,7 +126,9 @@ export async function removeFromCart(lineItemId) {
 }
 
 /**
- * Create a checkout from the current cart and return the Wix-hosted checkout URL.
+ * Start the hosted checkout for the current cart and return the Wix-hosted checkout URL.
+ * In Cart V2 the cart id IS the checkout id — there is no separate checkout-creation call; the
+ * redirect session is created straight from the current cart's id.
  * Throws on empty cart, unavailable lines, or a missing redirect URL.
  * Redirect with: window.location.href = await checkout()
  * @returns {Promise<string>}
@@ -133,22 +137,16 @@ export async function checkout() {
   const cart = await getCurrentCart();
   const lines = cart?.lineItems ?? [];
   if (!lines.length) throw new Error("Cannot check out: the cart is empty.");
-  const unavailable = lines.filter((l) => l.availability?.status && l.availability.status !== "AVAILABLE");
+  const unavailable = lines.filter((l) => l.status && l.status !== "IN_STOCK");
   if (unavailable.length) {
-    const names = unavailable.map((l) => l.productName?.original ?? l.catalogReference?.catalogItemId).join(", ");
+    const names = unavailable.map((l) => l.name?.original ?? l.source?.catalogReference?.catalogItemId).join(", ");
     throw new Error(`Cannot check out: ${unavailable.length} item(s) not available — ${names}.`);
   }
-
-  const checkoutRes = await wixApiRequest("/ecom/v1/carts/current/create-checkout", {
-    method: "POST",
-    body: { channelType: "WEB" },
-  });
-  const checkoutId = checkoutRes?.checkoutId;
-  if (!checkoutId) throw new Error("Failed to create checkout from the current cart.");
+  if (!cart.id) throw new Error("Failed to check out: the current cart has no id.");
 
   const redirect = await wixApiRequest("/headless/v1/redirect-session", {
     method: "POST",
-    body: { ecomCheckout: { checkoutId }, callbacks: { postFlowUrl: window.location.href } },
+    body: { ecomCheckout: { checkoutId: cart.id }, callbacks: { postFlowUrl: window.location.href } },
   });
   const url = redirect?.redirectSession?.fullUrl;
   if (!url) throw new Error("Failed to create the checkout redirect session.");