hookwright 1.13.0 → 2.0.1

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.13.0",
+      version: "2.0.1",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -1807,26 +1807,40 @@ function selectionFor4(eventName) {
   return eventDef3(eventName).selection;
 }
 var COMMON_FIELDS3 = [
-  { source: "request_type", target: "\xABgate\xBB + requestType", required: true, note: "return or exchange" },
-  { source: "status", target: "\xABgate\xBB + status", required: true, note: "requested, approved, received, inspected or rejected" },
-  { source: "customer.phone", target: "phone", required: true, note: "missing phone is rejected on every event" },
-  { source: "customer.address.country_code", target: "phone region" },
-  { source: "request_number", target: "requestNumber" },
-  { source: "order.name", target: "order.name" },
-  { source: "line_items[].original_product.title", target: "product.name", required: true, note: "the first PAID line wins; freebies rank last" },
-  { source: "line_items[].original_product.image.src", target: "product.image" },
-  { source: "line_items[].original_product.price", target: "product.price", note: "a zero price marks the line a freebie" },
-  { source: "line_items[].reason", target: "reason" },
-  { source: "line_items[].presentment_price.actual_amount", target: "pricing.totalPrice" },
-  { source: "line_items[].return_fee.price_set\u2026amount", target: "pricing.returnFee" },
-  { source: "line_items[].refund.status", target: "refund.status" },
-  { source: "line_items[].refund.meta.discount_code", target: "refund.discountCode", note: "only present once store credit is issued" },
-  { source: "line_items[].shipping[0].awb", target: "shipping.awb" },
-  { source: "approved/received/inspected/rejected.created_at", target: "timeline.*" }
+  { 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" },
+  { source: "request.customer.phone", target: "phone", required: true, note: "missing phone is rejected on every event" },
+  { source: "request.customer.address.country_code", target: "phone region" },
+  { source: "request.customer.name", target: "customer.name" },
+  { source: "request.customer.email", target: "customer.email", note: "null on some real requests" },
+  { source: "request.request_number", target: "requestNumber" },
+  { source: "request.id", target: "requestId" },
+  { source: "request.manual_request", target: "manualRequest" },
+  { source: "request.smart_exchange", target: "smartExchange" },
+  { source: "request.order.name", target: "order.name" },
+  { source: "request.order.id", target: "order.id" },
+  { source: "request.line_items[].original_product.title", target: "product.name + product.details", required: true, note: "the first PAID line wins; freebies rank last" },
+  { source: "request.line_items[].original_product.image.src", target: "product.image" },
+  { source: "request.line_items[].original_product.price", target: "product.price", note: "a zero price marks the line a freebie" },
+  { source: "request.line_items[].original_product.sku", target: "product.sku" },
+  { source: "request.line_items[].reason", target: "reason" },
+  { source: "request.line_items[].quantity", target: "product.quantity" },
+  { source: "request.line_items[].presentment_price.actual_amount", target: "pricing.totalPrice" },
+  { source: "request.line_items[].presentment_price.currency", target: "pricing.currency" },
+  { source: "request.line_items[].return_fee.price_set.presentment_money.amount", target: "pricing.returnFee" },
+  { source: "request.line_items[].refund.status", target: "refund.status" },
+  { source: "request.line_items[].refund.requested_mode", target: "refund.requestedMode" },
+  { source: "request.line_items[].refund.meta.discount_code", target: "refund.discountCode", note: "only present once store credit is issued" },
+  { source: "request.line_items[].shipping[0].awb", target: "shipping.awb", note: "absent until a label is raised" },
+  { source: "request.line_items[].shipping[0].tracking_available", target: "shipping.trackingAvailable" },
+  { source: "request.approved.created_at / request.received.created_at / request.inspected.created_at / request.rejected.created_at", target: "timeline.*", note: "whichever steps have happened" },
+  { source: "request.created_at", target: "createdAt" }
 ];
 var EXCHANGE_FIELDS = [
-  { source: "line_items[].exchange_product.title", target: "exchangeProduct.name", note: "exchanges only \u2014 returns never carry it" },
-  { source: "line_items[].exchange_product.price", target: "exchangeProduct.price + pricing.priceDifference", note: "difference is signed: positive means the shopper owes more" }
+  { source: "request.line_items[].exchange_product.title", target: "exchangeProduct.name", note: "exchanges only \u2014 returns never carry it" },
+  { source: "request.line_items[].exchange_product.price", target: "exchangeProduct.price + pricing.priceDifference", note: "difference is signed: positive means the shopper owes more" },
+  { source: "request.line_items[].exchange_product.image.src", target: "exchangeProduct.image" },
+  { source: "request.line_items[].exchange_product.sku", target: "exchangeProduct.sku" }
 ];
 var fieldMap6 = COMMON_FIELDS3;
 function fieldMapFor2(eventName) {
@@ -1864,124 +1878,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 = 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)}`,
@@ -1996,7 +2015,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: {
@@ -2026,7 +2045,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 };

package/package.json

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