hookwright 2.0.1 → 2.2.0

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "2.0.1",
+      version: "2.2.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" },
@@ -1868,7 +1875,7 @@ function editableFieldsFor3(eventName) {
 }
 var editableFields6 = editableFieldsFor3(DEFAULT_EVENT4);
 function statusBlock(reached, at, comment = null) {
-  return { status: reached, comment, created_at: reached ? at : null };
+  return { status: reached, comment: comment ?? "quickreply test", created_at: at };
 }
 function buildPayload6(ctx) {
   const { config, items, phone } = ctx;
@@ -1891,14 +1898,14 @@ function buildPayload6(ctx) {
       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",
+        actual_mode: "store_credit",
+        meta: { discount_code: ctx.couponCode ?? `RP${String(now.getTime()).slice(-7)}` },
+        status: def.status === "requested" ? "pending" : "refunded",
         refunded_amount: {
-          shop_money: { ...def.status === "rejected" ? { amount: originalPrice } : {}, currency_code: currency },
-          presentment_money: { ...def.status === "rejected" ? { amount: originalPrice } : {}, currency_code: currency }
+          shop_money: { amount: originalPrice, currency_code: currency },
+          presentment_money: { amount: originalPrice, currency_code: currency }
         },
-        refunded_at: def.status === "rejected" ? at : null,
+        refunded_at: at,
         comment: null
       },
       return_fee: {
@@ -1910,8 +1917,8 @@ function buildPayload6(ctx) {
       },
       exchange_fee: {
         price_set: {
-          shop_money: { amount: null, currency_code: null },
-          presentment_money: { amount: null, currency_code: null }
+          shop_money: { amount: ctx.exchangeFee ?? 0, currency_code: currency },
+          presentment_money: { amount: ctx.exchangeFee ?? 0, currency_code: currency }
         }
       },
       exchange: { order: null },
@@ -1940,7 +1947,7 @@ function buildPayload6(ctx) {
         }
       } : {},
       shipping: [
-        def.status === "requested" ? { tracking_available: false, labels: [] } : {
+        {
           shipping_company: "bluedartV2",
           tracking_available: true,
           awb: String(now.getTime()).slice(-11),
@@ -1973,13 +1980,13 @@ function buildPayload6(ctx) {
         do_not_carry_forward_discount: true
       },
       shopify_order_fulfillment_location: null,
-      return_location: def.status === "requested" ? null : {
+      return_location: {
         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 ?? "",
+        streetAddress2: cust.address2 || "Second line",
         landmark: "",
         city: cust.city,
         state: cust.province,
@@ -2032,7 +2039,7 @@ function buildPayload6(ctx) {
         country_code: cust.countryCode,
         province_code: cust.provinceCode,
         address_line_1: cust.address1,
-        address_line_2: cust.address2 ?? "",
+        address_line_2: cust.address2 || "Second line",
         country: cust.country,
         address_line_3: ""
       },
@@ -2092,6 +2099,7 @@ var return_prime_default = {
   editableFields: editableFields6,
   editableFieldsFor: editableFieldsFor3,
   selectionFor: selectionFor4,
+  pickPromptFor,
   eventFromPayload: eventFromPayload4,
   buildPayload: buildPayload6,
   sign: sign6,
@@ -3571,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;
@@ -3585,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;
@@ -3600,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");
@@ -3609,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) : {};
@@ -3905,6 +3914,7 @@ var STEP = {
   LOADING: "loading",
   COLLECTION: "collection",
   PICK: "pick",
+  REPLACEMENT: "replacement",
   VARIANT: "variant",
   QUANTITY: "quantity",
   DELTA: "delta",
@@ -3932,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);
@@ -4054,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;
@@ -4114,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)) {
@@ -4129,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);
@@ -4252,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(
@@ -4267,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.1",
+  "version": "2.2.0",
   "description": "Build real, signed e-commerce webhooks from a live Shopify catalogue — interactive terminal UI, no backend",
   "keywords": [
     "webhook",