hookwright 2.0.0 → 2.1.0

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "2.0.0",
+      version: "2.1.0",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -1792,8 +1792,12 @@ var EVENTS4 = ["return", "exchange"].flatMap(
     status,
     type: `return_prime_${requestType}_${status}`,
     label: `${titleCase(requestType)} ${titleCase(status)}`,
-    selection: requestType === "exchange" ? "exchange" : "product",
-    subject: requestType === "exchange" ? "the returned product and its replacement" : "the returned product"
+    // A return is one or more products sent back, so it is a multi pick, not the
+    // single "which product was viewed" a browsing event asks for. An exchange is
+    // the same list, followed by the replacement chosen for each line.
+    selection: requestType === "exchange" ? "exchange" : "cart",
+    subject: requestType === "exchange" ? "the returned products and their replacements" : "the returned products",
+    pickPrompt: requestType === "exchange" ? "Select the products being returned for exchange" : "Select the products being returned"
   }))
 );
 var DEFAULT_EVENT4 = "return_requested";
@@ -1806,6 +1810,9 @@ function eventFromPayload4(payload) {
 function selectionFor4(eventName) {
   return eventDef3(eventName).selection;
 }
+function pickPromptFor(eventName) {
+  return eventDef3(eventName).pickPrompt;
+}
 var COMMON_FIELDS3 = [
   { source: "request.request_type", target: "\xABgate\xBB + requestType", required: true, note: "return or exchange" },
   { source: "request.status", target: "\xABgate\xBB + status", required: true, note: "requested, approved, received, inspected or rejected" },
@@ -1878,124 +1885,129 @@ function buildPayload6(ctx) {
   const currency = ctx.currency || config.defaults.currency;
   const cust = config.customer;
   const at = now.toISOString();
-  const first = items?.[0];
-  const second = ctx.exchange ?? items?.[1] ?? first;
-  const originalPrice = money2(first?.variant?.price ?? 0);
-  const exchangePrice = money2(second?.variant?.price ?? 0);
+  const selected = (items ?? []).filter(Boolean);
+  const replacements = ctx.exchangeItems ?? (ctx.exchange ? [ctx.exchange] : []);
+  const replacementFor = (sel, idx) => replacements[idx] ?? ctx.exchange ?? sel;
   const reachedIndex = STATUSES.indexOf(def.status);
   const reached = (name) => STATUSES.indexOf(name) <= reachedIndex && def.status !== "requested";
-  const lineItem = {
-    id: Number(first?.variant?.id ?? first?.product?.id ?? 0),
-    refund: {
-      requested_mode: "store_credit",
-      actual_mode: def.status === "rejected" ? "store_credit" : null,
-      meta: def.status === "rejected" && ctx.couponCode ? { discount_code: ctx.couponCode } : null,
-      status: def.status === "rejected" ? "refunded" : "pending",
-      refunded_amount: {
-        shop_money: { ...def.status === "rejected" ? { amount: originalPrice } : {}, currency_code: currency },
-        presentment_money: { ...def.status === "rejected" ? { amount: originalPrice } : {}, currency_code: currency }
+  const makeLineItem = (sel, idx) => {
+    const repl = replacementFor(sel, idx);
+    const originalPrice = money2(sel?.variant?.price ?? 0);
+    const exchangePrice = money2(repl?.variant?.price ?? 0);
+    return {
+      id: Number(sel?.variant?.id ?? sel?.product?.id ?? 0),
+      refund: {
+        requested_mode: "store_credit",
+        actual_mode: def.status === "rejected" ? "store_credit" : null,
+        meta: def.status === "rejected" && ctx.couponCode ? { discount_code: ctx.couponCode } : null,
+        status: def.status === "rejected" ? "refunded" : "pending",
+        refunded_amount: {
+          shop_money: { ...def.status === "rejected" ? { amount: originalPrice } : {}, currency_code: currency },
+          presentment_money: { ...def.status === "rejected" ? { amount: originalPrice } : {}, currency_code: currency }
+        },
+        refunded_at: def.status === "rejected" ? at : null,
+        comment: null
       },
-      refunded_at: def.status === "rejected" ? at : null,
-      comment: null
-    },
-    return_fee: {
-      price_set: {
-        shop_money: { amount: ctx.returnFee ?? 0, currency_code: currency },
-        presentment_money: { amount: ctx.returnFee ?? 0, currency_code: currency }
+      return_fee: {
+        price_set: {
+          shop_money: { amount: ctx.returnFee ?? 0, currency_code: currency },
+          presentment_money: { amount: ctx.returnFee ?? 0, currency_code: currency }
+        },
+        rule: "order"
       },
-      rule: "order"
-    },
-    exchange_fee: {
-      price_set: {
-        shop_money: { amount: null, currency_code: null },
-        presentment_money: { amount: null, currency_code: null }
-      }
-    },
-    exchange: { order: null },
-    original_product: {
-      title: first?.product?.title,
-      variant_title: first?.variant?.title ?? null,
-      product_id: Number(first?.product?.id ?? 0),
-      variant_id: Number(first?.variant?.id ?? 0),
-      image: { src: imageForVariant(first?.product, first?.variant) },
-      price: originalPrice,
-      sku: first?.variant?.sku || "",
-      variant_deleted: false,
-      product_deleted: false
-    },
-    ...def.requestType === "exchange" ? {
-      exchange_product: {
-        product_id: Number(second?.product?.id ?? 0),
-        title: second?.product?.title,
-        variant_title: second?.variant?.title ?? "Default Title",
-        variant_id: Number(second?.variant?.id ?? 0),
-        image: { src: imageForVariant(second?.product, second?.variant) },
-        price: exchangePrice,
-        sku: second?.variant?.sku || "",
+      exchange_fee: {
+        price_set: {
+          shop_money: { amount: null, currency_code: null },
+          presentment_money: { amount: null, currency_code: null }
+        }
+      },
+      exchange: { order: null },
+      original_product: {
+        title: sel?.product?.title,
+        variant_title: sel?.variant?.title ?? null,
+        product_id: Number(sel?.product?.id ?? 0),
+        variant_id: Number(sel?.variant?.id ?? 0),
+        image: { src: imageForVariant(sel?.product, sel?.variant) },
+        price: originalPrice,
+        sku: sel?.variant?.sku || "",
         variant_deleted: false,
         product_deleted: false
-      }
-    } : {},
-    shipping: [
-      def.status === "requested" ? { tracking_available: false, labels: [] } : {
-        shipping_company: "bluedartV2",
-        tracking_available: true,
-        awb: String(now.getTime()).slice(-11),
-        tracking_updated_at: null,
-        labels: [],
-        shipment_status: "Requested",
-        tracking_url: `https://www.bluedart.com/trackdartresultthirdparty?trackFor=0&trackNo=${String(now.getTime()).slice(-11)}`
-      }
-    ],
-    quantity: first?.quantity ?? 1,
-    reason: ctx.reason ?? "Size of Fit Issues",
-    shop_price: {
-      actual_amount: originalPrice,
-      total_tax: 0,
-      return_quantity: first?.quantity ?? 1,
-      total_discount: 0,
-      shipping_amount: 0,
-      taxes_included: true,
-      currency,
-      do_not_carry_forward_discount: true
-    },
-    presentment_price: {
-      actual_amount: originalPrice,
-      total_tax: 0,
-      return_quantity: first?.quantity ?? 1,
-      total_discount: 0,
-      shipping_amount: 0,
-      taxes_included: true,
-      currency,
-      do_not_carry_forward_discount: true
-    },
-    shopify_order_fulfillment_location: null,
-    return_location: def.status === "requested" ? null : {
-      id: "rp-location-1",
-      fullName: config.shopify.shop?.name ?? config.shopify.domain,
-      mobileNumber: nationalNumber(phone, cust.countryCode),
-      pinCode: cust.zip,
-      streetAddress1: cust.address1,
-      streetAddress2: cust.address2 ?? "",
-      landmark: "",
-      city: cust.city,
-      state: cust.province,
-      stateCode: cust.provinceCode,
-      countryCode: cust.countryCode,
-      country: cust.country,
-      store: config.shopify.domain,
-      facilityCode: "",
-      isDefault: true,
-      latitude: "",
-      longitude: "",
-      inStoreReturnExchange: false,
-      external: false,
-      createdAt: at,
-      updatedAt: at
-    },
-    notes: null,
-    tags: []
+      },
+      ...def.requestType === "exchange" ? {
+        exchange_product: {
+          product_id: Number(repl?.product?.id ?? 0),
+          title: repl?.product?.title,
+          variant_title: repl?.variant?.title ?? "Default Title",
+          variant_id: Number(repl?.variant?.id ?? 0),
+          image: { src: imageForVariant(repl?.product, repl?.variant) },
+          price: exchangePrice,
+          sku: repl?.variant?.sku || "",
+          variant_deleted: false,
+          product_deleted: false
+        }
+      } : {},
+      shipping: [
+        def.status === "requested" ? { tracking_available: false, labels: [] } : {
+          shipping_company: "bluedartV2",
+          tracking_available: true,
+          awb: String(now.getTime()).slice(-11),
+          tracking_updated_at: null,
+          labels: [],
+          shipment_status: "Requested",
+          tracking_url: `https://www.bluedart.com/trackdartresultthirdparty?trackFor=0&trackNo=${String(now.getTime()).slice(-11)}`
+        }
+      ],
+      quantity: sel?.quantity ?? 1,
+      reason: ctx.reason ?? "Size of Fit Issues",
+      shop_price: {
+        actual_amount: originalPrice,
+        total_tax: 0,
+        return_quantity: sel?.quantity ?? 1,
+        total_discount: 0,
+        shipping_amount: 0,
+        taxes_included: true,
+        currency,
+        do_not_carry_forward_discount: true
+      },
+      presentment_price: {
+        actual_amount: originalPrice,
+        total_tax: 0,
+        return_quantity: sel?.quantity ?? 1,
+        total_discount: 0,
+        shipping_amount: 0,
+        taxes_included: true,
+        currency,
+        do_not_carry_forward_discount: true
+      },
+      shopify_order_fulfillment_location: null,
+      return_location: def.status === "requested" ? null : {
+        id: "rp-location-1",
+        fullName: config.shopify.shop?.name ?? config.shopify.domain,
+        mobileNumber: nationalNumber(phone, cust.countryCode),
+        pinCode: cust.zip,
+        streetAddress1: cust.address1,
+        streetAddress2: cust.address2 ?? "",
+        landmark: "",
+        city: cust.city,
+        state: cust.province,
+        stateCode: cust.provinceCode,
+        countryCode: cust.countryCode,
+        country: cust.country,
+        store: config.shopify.domain,
+        facilityCode: "",
+        isDefault: true,
+        latitude: "",
+        longitude: "",
+        inStoreReturnExchange: false,
+        external: false,
+        createdAt: at,
+        updatedAt: at
+      },
+      notes: null,
+      tags: []
+    };
   };
+  const lineItems = selected.map(makeLineItem);
   const request = {
     id: `rp-${now.getTime()}`,
     request_number: ctx.requestNumber ?? `${def.requestType === "exchange" ? "EXC" : "RET"}${String(now.getTime()).slice(-3)}`,
@@ -2010,7 +2022,7 @@ function buildPayload6(ctx) {
       name: ctx.orderName ?? `#${String(now.getTime()).slice(-5)}`,
       order_manual_payment: false,
       payment_gateways: [],
-      fulfillments: [{ id: Number(String(now.getTime()).slice(-10)), line_items: [lineItem.id], delivery_status: null, delivery_date: null }],
+      fulfillments: [{ id: Number(String(now.getTime()).slice(-10)), line_items: lineItems.map((li) => li.id), delivery_status: null, delivery_date: null }],
       created_at: at
     },
     customer: {
@@ -2040,7 +2052,7 @@ function buildPayload6(ctx) {
     archived: statusBlock(false, at),
     unarchived: statusBlock(false, at),
     incentive: null,
-    line_items: [lineItem],
+    line_items: lineItems,
     created_at: at
   };
   return ctx.envelope === "root" ? request : { request };
@@ -2087,6 +2099,7 @@ var return_prime_default = {
   editableFields: editableFields6,
   editableFieldsFor: editableFieldsFor3,
   selectionFor: selectionFor4,
+  pickPromptFor,
   eventFromPayload: eventFromPayload4,
   buildPayload: buildPayload6,
   sign: sign6,
@@ -3566,7 +3579,7 @@ function loadPayload(file) {
 }
 
 // src/core/build.mjs
-function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, phone, eventName, collection, envelope, live, delta }) {
+function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, phone, eventName, collection, envelope, live, delta, exchangeItems }) {
   const provider = getProvider(providerId);
   const event = eventName ?? provider.defaultEvent;
   const resolvedPhone = phone ?? cfg.customer.phone;
@@ -3580,6 +3593,7 @@ function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, p
     envelope,
     live,
     delta,
+    exchangeItems,
     phone: parsed.ok ? parsed.value : String(resolvedPhone ?? "")
   });
   const editable = provider.editableFieldsFor ? provider.editableFieldsFor(event) : provider.editableFields;
@@ -3595,7 +3609,7 @@ function applyEdits(payload, fields, edits) {
   }
   return payload;
 }
-async function buildPayload10({ cfg, providerId = "cashfree-occ", items = [], discount = 0, phone, checkImageUrls = true, payload: prebuilt, eventName, collection, envelope, live, delta }) {
+async function buildPayload10({ cfg, providerId = "cashfree-occ", items = [], discount = 0, phone, checkImageUrls = true, payload: prebuilt, eventName, collection, envelope, live, delta, exchangeItems }) {
   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");
@@ -3604,7 +3618,7 @@ async function buildPayload10({ cfg, providerId = "cashfree-occ", items = [], di
   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, delta });
+  const payload = prebuilt ?? provider.buildPayload({ config: cfg, items, discount, phone: parsed.value, eventName: event, collection, envelope, live, delta, exchangeItems });
   const body = JSON.stringify(payload);
   const report = await runAll({ payload, body, provider, config: cfg, checkImageUrls, eventName: event });
   const summary = provider.summarize ? provider.summarize(payload) : {};
@@ -3900,6 +3914,7 @@ var STEP = {
   LOADING: "loading",
   COLLECTION: "collection",
   PICK: "pick",
+  REPLACEMENT: "replacement",
   VARIANT: "variant",
   QUANTITY: "quantity",
   DELTA: "delta",
@@ -3927,6 +3942,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
   const [cursor, setCursor] = useState(0);
   const [items, setItems] = useState([]);
   const [pendingVariant, setPendingVariant] = useState(null);
+  const [exchangeItems, setExchangeItems] = useState([]);
   const [delta, setDelta] = useState([]);
   const isDeltaEvent = providerId === "nitro" && (eventName === "addtocart" || eventName === "removefromcart");
   const [draft, setDraft] = useState(null);
@@ -4049,10 +4065,18 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
       alive = false;
     };
   }, [step === STEP.EVENT, eventName]);
+  const onReplacementsPicked = (ids) => {
+    const picked = ids.map((id) => products.find((p) => p.id === id)).filter(Boolean);
+    if (!picked.length) return;
+    const pairs = picked.map((p) => ({ product: p, variant: p.variants[0], quantity: 1 }));
+    setExchangeItems(pairs);
+    startReview(0, collection, items, delta, pairs);
+  };
   const advance = (nextItems, nextCursor) => {
     if (nextCursor >= chosen.length) {
       setItems(nextItems);
       if (isDeltaEvent) setStep(STEP.DELTA);
+      else if (selection === "exchange") setStep(STEP.REPLACEMENT);
       else if (selection === "cart") setStep(STEP.DISCOUNT);
       else startReview(0, collection, nextItems);
       return;
@@ -4109,7 +4133,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, chosenDelta = delta) => {
+  const startReview = async (discount, chosenCollection = collection, chosenItems = items, chosenDelta = delta, chosenExchange = exchangeItems) => {
     try {
       let live = null;
       if (needsLive(providerId, eventName)) {
@@ -4124,7 +4148,8 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         eventName,
         collection: chosenCollection,
         live,
-        delta: chosenDelta
+        delta: chosenDelta,
+        exchangeItems: chosenExchange
       });
       setDraft({ ...next, discount, live, delta: chosenDelta });
       setStep(STEP.MODE);
@@ -4247,7 +4272,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
     ] }),
     step === STEP.PICK && selection !== "product" && /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
       /* @__PURE__ */ jsxs8(Text8, { children: [
-        `Select the products in the cart `,
+        `${provider.pickPromptFor?.(eventName) ?? "Select the products in the cart"} `,
         /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: "(space toggles \xB7 enter confirms)" })
       ] }),
       /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(
@@ -4262,6 +4287,24 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         }
       ) })
     ] }),
+    step === STEP.REPLACEMENT && /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsxs8(Text8, { children: [
+        "What is each returned line being exchanged for? ",
+        /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: "(space toggles \xB7 enter confirms)" })
+      ] }),
+      /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: `Picked in order, paired with the ${items.length} line${items.length === 1 ? "" : "s"} coming back.` }),
+      /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(
+        MultiSelect,
+        {
+          visibleOptionCount: 10,
+          options: products.map((p) => ({
+            label: `${truncate(p.title, 44).padEnd(45)} ${money(p.variants[0]?.price, currency)}`,
+            value: p.id
+          })),
+          onSubmit: onReplacementsPicked
+        }
+      ) })
+    ] }),
     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? ",

package/package.json

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