hookwright 1.6.0 → 1.8.0

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.6.0",
+      version: "1.8.0",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -163,6 +163,9 @@ var DEFAULT_CONFIG = {
   shopify: {
     domain: "",
     accessToken: "",
+    // Storefront API token. Creating a checkout needs one: the admin checkout API
+    // was removed, so a fresh checkout can only be minted through the storefront.
+    storefrontAccessToken: "",
     apiVersion: "2024-10",
     // cached from the last successful connection, for display only
     shop: null
@@ -911,7 +914,7 @@ function editableFieldsFor(eventName) {
 }
 var editableFields3 = editableFieldsFor(DEFAULT_EVENT);
 function buildPayload3(ctx) {
-  const { config, items, phone, live } = ctx;
+  const { config, items, phone, live, delta } = ctx;
   const eventName = ctx.eventName ?? DEFAULT_EVENT;
   const now = ctx.now ?? /* @__PURE__ */ new Date();
   const currency = ctx.currency || config.defaults.currency;
@@ -1022,16 +1025,18 @@ function buildPayload3(ctx) {
     case "addtocart":
     case "removefromcart": {
       const added = eventName === "addtocart";
-      const removed = added ? [] : items.slice(-1);
-      const remaining = added ? items : items.slice(0, -1);
+      const fallback = added ? items : items.slice(-1);
+      const moved = delta?.length ? items.filter((item) => delta.includes(item)) : fallback;
+      const untouched = items.filter((item) => !moved.includes(item));
+      const cart = added ? items : untouched;
       eventVal = {
-        line_items: added ? lineItems : remaining.map(cartLine),
-        cart_value: added ? cartValue : valueOf(remaining),
-        recent_product_image: added ? lineItems[0]?.image_url ?? null : null,
+        line_items: cart.map(cartLine),
+        cart_value: valueOf(cart),
+        recent_product_image: added ? moved.map(cartLine)[0]?.image_url ?? null : null,
         init_cart: false,
-        empty_cart: !added && remaining.length === 0,
-        items_added: added ? lineItems : [],
-        items_removed: removed.map(removedLine),
+        empty_cart: !added && cart.length === 0,
+        items_added: added ? moved.map(cartLine) : [],
+        items_removed: added ? [] : moved.map(removedLine),
         customer,
         bik_customer_id: null
       };
@@ -2491,6 +2496,33 @@ var ShopifyClient = class {
     const { json } = await this.request("/checkouts.json", { query: { limit } });
     return json?.checkouts ?? [];
   }
+  /**
+   * Creates a real checkout through the storefront API and returns its recovery
+   * link. The admin checkout API was removed, so this is the only way to mint a
+   * new one; it needs a storefront token, which is separate from the admin one.
+   */
+  async createCheckout({ storefrontAccessToken, lineItems, email }) {
+    if (!storefrontAccessToken) throw new ShopifyError("Storefront access token missing", { hint: "run `hookwright configure` and add it, or the checkout event reuses an existing checkout" });
+    const mutation = `mutation checkoutCreate($input: CheckoutCreateInput!) {
+      checkoutCreate(input: $input) {
+        checkout { id webUrl totalPrice { amount currencyCode } }
+        checkoutUserErrors { field message }
+      }
+    }`;
+    const input = { lineItems: lineItems.map(({ variantId, quantity }) => ({ variantId: `gid://shopify/ProductVariant/${variantId}`, quantity })) };
+    if (email) input.email = email;
+    const res = await fetch(`https://${this.domain}/api/2024-01/graphql.json`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", "X-Shopify-Storefront-Access-Token": storefrontAccessToken },
+      body: JSON.stringify({ query: mutation, variables: { input } })
+    });
+    const body = await res.json();
+    const errors = body.errors ?? body.data?.checkoutCreate?.checkoutUserErrors;
+    if (errors?.length) throw new ShopifyError(`Shopify rejected the checkout: ${errors.map((e) => e.message).join("; ")}`, { hint: "the storefront token needs unauthenticated_write_checkouts" });
+    const checkout = body.data?.checkoutCreate?.checkout;
+    if (!checkout) throw new ShopifyError("Shopify returned no checkout", { hint: "check the storefront token and api version" });
+    return checkout;
+  }
   /** Orders, newest first. */
   async orders({ limit = 10, status = "any" } = {}) {
     const { json } = await this.request("/orders.json", { query: { limit, status } });
@@ -2908,7 +2940,7 @@ function loadPayload(file) {
 }
 
 // src/core/build.mjs
-function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, phone, eventName, collection, envelope, live }) {
+function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, phone, eventName, collection, envelope, live, delta }) {
   const provider = getProvider(providerId);
   const event = eventName ?? provider.defaultEvent;
   const resolvedPhone = phone ?? cfg.customer.phone;
@@ -2921,6 +2953,7 @@ function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, p
     collection,
     envelope,
     live,
+    delta,
     phone: parsed.ok ? parsed.value : String(resolvedPhone ?? "")
   });
   const editable = provider.editableFieldsFor ? provider.editableFieldsFor(event) : provider.editableFields;
@@ -2936,7 +2969,7 @@ function applyEdits(payload, fields, edits) {
   }
   return payload;
 }
-async function buildPayload8({ cfg, providerId = "cashfree-occ", items = [], discount = 0, phone, checkImageUrls = true, payload: prebuilt, eventName, collection, envelope, live }) {
+async function buildPayload8({ cfg, providerId = "cashfree-occ", items = [], discount = 0, phone, checkImageUrls = true, payload: prebuilt, eventName, collection, envelope, live, delta }) {
   const provider0 = getProvider(providerId);
   const needsItems = !provider0.selectionFor || ["cart", "product"].includes(provider0.selectionFor(eventName ?? provider0.defaultEvent));
   if (needsItems && !items.length) throw new ConfigError("no products selected");
@@ -2945,7 +2978,7 @@ async function buildPayload8({ cfg, providerId = "cashfree-occ", items = [], dis
   const parsed = toE164(resolvedPhone, cfg.customer.countryCode);
   if (!parsed.ok) throw new ConfigError(`phone is unusable: ${parsed.reason}`);
   const event = eventName ?? provider.defaultEvent;
-  const payload = prebuilt ?? provider.buildPayload({ config: cfg, items, discount, phone: parsed.value, eventName: event, collection, envelope, live });
+  const payload = prebuilt ?? provider.buildPayload({ config: cfg, items, discount, phone: parsed.value, eventName: event, collection, envelope, live, delta });
   const body = JSON.stringify(payload);
   const report = await runAll({ payload, body, provider, config: cfg, checkImageUrls, eventName: event });
   const summary = provider.summarize ? provider.summarize(payload) : {};
@@ -2988,6 +3021,19 @@ function clientFor(config) {
   });
 }
 async function liveCheckout({ config, items = [], client = clientFor(config) }) {
+  const storefrontAccessToken = config.shopify?.storefrontAccessToken;
+  const lineItems = items.map(({ variant, product, quantity }) => ({ variantId: Number(variant?.id ?? product?.id), quantity: Number(quantity) || 1 })).filter((l) => Number.isFinite(l.variantId) && l.variantId > 0);
+  if (storefrontAccessToken && lineItems.length) {
+    const checkout2 = await client.createCheckout({ storefrontAccessToken, lineItems, email: config.customer?.email || void 0 });
+    return {
+      kind: "checkout",
+      created: true,
+      url: checkout2.webUrl,
+      cartValue: money2(checkout2.totalPrice?.amount ?? 0).toFixed(2),
+      cartToken: /\/checkouts\/([^/?]+)/.exec(checkout2.webUrl ?? "")?.[1],
+      lineItems: []
+    };
+  }
   const checkouts = await client.abandonedCheckouts({ limit: 20 });
   if (checkouts.length === 0) return null;
   const wanted = new Set(items.map(({ variant }) => Number(variant?.id)).filter(Boolean));
@@ -2995,6 +3041,7 @@ async function liveCheckout({ config, items = [], client = clientFor(config) })
   const checkout = matching ?? checkouts[0];
   return {
     kind: "checkout",
+    created: false,
     url: checkout.abandoned_checkout_url,
     cartValue: money2(checkout.total_price ?? 0).toFixed(2),
     cartToken: checkout.cart_token,
@@ -3224,6 +3271,7 @@ var STEP = {
   PICK: "pick",
   VARIANT: "variant",
   QUANTITY: "quantity",
+  DELTA: "delta",
   DISCOUNT: "discount",
   LIVE: "live",
   MODE: "mode",
@@ -3248,6 +3296,8 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
   const [cursor, setCursor] = useState(0);
   const [items, setItems] = useState([]);
   const [pendingVariant, setPendingVariant] = useState(null);
+  const [delta, setDelta] = useState([]);
+  const isDeltaEvent = providerId === "nitro" && (eventName === "addtocart" || eventName === "removefromcart");
   const [draft, setDraft] = useState(null);
   const [fieldIndex, setFieldIndex] = useState(0);
   const [edits, setEdits] = useState({});
@@ -3281,6 +3331,8 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         setItems(items.slice(0, -1));
         return stepInto(last);
       }
+      case STEP.DELTA:
+        return setStep(STEP.PICK);
       case STEP.LIVE:
       case STEP.MODE:
         return setStep(STEP.DISCOUNT);
@@ -3369,7 +3421,8 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
   const advance = (nextItems, nextCursor) => {
     if (nextCursor >= chosen.length) {
       setItems(nextItems);
-      if (selection === "cart") setStep(STEP.DISCOUNT);
+      if (isDeltaEvent) setStep(STEP.DELTA);
+      else if (selection === "cart") setStep(STEP.DISCOUNT);
       else startReview(0, collection, nextItems);
       return;
     }
@@ -3425,7 +3478,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
     const nextItems = [...items, { product, variant: pendingVariant, quantity: qty }];
     advance(nextItems, cursor + 1);
   };
-  const startReview = async (discount, chosenCollection = collection, chosenItems = items) => {
+  const startReview = async (discount, chosenCollection = collection, chosenItems = items, chosenDelta = delta) => {
     try {
       let live = null;
       if (needsLive(providerId, eventName)) {
@@ -3439,19 +3492,26 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         discount,
         eventName,
         collection: chosenCollection,
-        live
+        live,
+        delta: chosenDelta
       });
-      setDraft({ ...next, discount, live });
+      setDraft({ ...next, discount, live, delta: chosenDelta });
       setStep(STEP.MODE);
     } catch (err) {
       setError({ message: err.message, hint: err.hint, failures: err.failures });
       setStep(STEP.ERROR);
     }
   };
+  const onDelta = (ids) => {
+    const picked = items.filter((i) => ids.includes(String(i.variant?.id ?? i.product?.id)));
+    if (!picked.length) return;
+    setDelta(picked);
+    startReview(0, collection, items, picked);
+  };
   const onDiscount = (raw) => startReview(Math.max(0, Number.parseFloat(raw) || 0));
   const finalise = (payload) => {
     setStep(STEP.BUILDING);
-    buildPayload8({ cfg: config, providerId, items, discount: draft.discount, payload, eventName, collection, live: draft.live }).then(async (result) => {
+    buildPayload8({ cfg: config, providerId, items, discount: draft.discount, payload, eventName, collection, live: draft.live, delta: draft.delta }).then(async (result) => {
       setBuilt(result);
       let req = null;
       let command = "";
@@ -3571,6 +3631,24 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         }
       ) })
     ] }),
+    step === STEP.DELTA && /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs8(Text8, { children: [
+        eventName === "addtocart" ? "Which of those lines is the shopper adding now? " : "Which of those lines is the shopper removing? ",
+        /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: "(space toggles \xB7 enter confirms)" })
+      ] }),
+      /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: eventName === "addtocart" ? "The rest were already in the cart." : "The rest stay in the cart." }),
+      /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(
+        MultiSelect,
+        {
+          visibleOptionCount: 10,
+          options: items.map((i) => ({
+            label: `${truncate(i.product.title, 40).padEnd(41)} x${String(i.quantity).padEnd(3)} ${money(i.variant?.price, currency)}`,
+            value: String(i.variant?.id ?? i.product?.id)
+          })),
+          onSubmit: onDelta
+        }
+      ) })
+    ] }),
     step === STEP.VARIANT && /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
       /* @__PURE__ */ jsxs8(Text8, { children: [
         `Variant for `,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hookwright",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Build real, signed e-commerce webhooks from a live Shopify catalogue — interactive terminal UI, no backend",
   "keywords": [
     "webhook",