hookwright 1.5.0 → 1.7.0

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.5.0",
+      version: "1.7.0",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -911,7 +911,7 @@ function editableFieldsFor(eventName) {
 }
 var editableFields3 = editableFieldsFor(DEFAULT_EVENT);
 function buildPayload3(ctx) {
-  const { config, items, phone } = 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 +1022,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
       };
@@ -1039,8 +1041,8 @@ function buildPayload3(ctx) {
     }
     case "checkout":
       eventVal = {
-        checkout: cartPermalink(domain, items.map(({ variant, quantity }) => ({ variantId: variant?.id, quantity }))),
-        cart_value: cartValue.toFixed(2),
+        checkout: live?.kind === "checkout" ? live.url : cartPermalink(domain, items.map(({ variant, quantity }) => ({ variantId: variant?.id, quantity }))),
+        cart_value: live?.kind === "checkout" ? live.cartValue : cartValue.toFixed(2),
         customer,
         bik_customer_id: null
       };
@@ -1048,7 +1050,17 @@ function buildPayload3(ctx) {
     case "orders/create":
     case "orders/updated": {
       const orderNumber = 1e3 + Math.floor(Math.random() * 9e3);
-      eventVal = {
+      eventVal = live?.kind === "order" ? {
+        url: live.statusUrl,
+        order_id: live.id,
+        order_number: live.number,
+        order_name: live.name,
+        price: live.price,
+        currency: live.currency ?? currency,
+        order_created_at: live.createdAt ?? now.toISOString(),
+        customer,
+        bik_customer_id: null
+      } : {
         url: `https://${domain}/${crypto3.randomBytes(5).toString("hex")}/orders/${crypto3.randomBytes(16).toString("hex")}/authenticate?key=${crypto3.randomBytes(16).toString("hex")}`,
         order_id: Number(`${Date.now()}`.slice(-13)),
         order_number: orderNumber,
@@ -2472,6 +2484,38 @@ var ShopifyClient = class {
     const { json } = await this.request("/products/count.json");
     return json?.count ?? 0;
   }
+  /**
+   * Abandoned checkouts, newest first. Nitro's checkout webhook carries a real
+   * recovery link, and the cart token inside it is what the receiving side looks
+   * the checkout up by — so it has to come from a checkout that actually exists.
+   */
+  async abandonedCheckouts({ limit = 10 } = {}) {
+    const { json } = await this.request("/checkouts.json", { query: { limit } });
+    return json?.checkouts ?? [];
+  }
+  /** Orders, newest first. */
+  async orders({ limit = 10, status = "any" } = {}) {
+    const { json } = await this.request("/orders.json", { query: { limit, status } });
+    return json?.orders ?? [];
+  }
+  /**
+   * Creates a real order. Receipts and inventory are suppressed: this exists to
+   * give an order webhook something true to point at, not to trade.
+   */
+  async createOrder(order) {
+    const { json } = await this.request("/orders.json", {
+      method: "POST",
+      body: {
+        order: {
+          ...order,
+          send_receipt: false,
+          send_fulfillment_receipt: false,
+          inventory_behaviour: "bypass"
+        }
+      }
+    });
+    return json?.order ?? null;
+  }
   /**
    * Collections, from both endpoints Shopify splits them across: custom
    * (manually curated) and smart (rule based). Either can back a category page.
@@ -2866,7 +2910,7 @@ function loadPayload(file) {
 }
 
 // src/core/build.mjs
-function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, phone, eventName, collection, envelope }) {
+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;
@@ -2878,6 +2922,8 @@ function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, p
     eventName: event,
     collection,
     envelope,
+    live,
+    delta,
     phone: parsed.ok ? parsed.value : String(resolvedPhone ?? "")
   });
   const editable = provider.editableFieldsFor ? provider.editableFieldsFor(event) : provider.editableFields;
@@ -2893,7 +2939,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 }) {
+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");
@@ -2902,7 +2948,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 });
+  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) : {};
@@ -2930,6 +2976,80 @@ async function buildPayload8({ cfg, providerId = "cashfree-occ", items = [], dis
   return { provider, payload, body, report, file, meta, summary, record };
 }
 
+// src/shopify/live.mjs
+var LIVE_EVENTS = {
+  nitro: /* @__PURE__ */ new Set(["checkout", "orders/create", "orders/updated"])
+};
+function needsLive(providerId, eventName) {
+  return LIVE_EVENTS[providerId]?.has(eventName) ?? false;
+}
+function clientFor(config) {
+  return new ShopifyClient({
+    domain: config.shopify.domain,
+    accessToken: config.shopify.accessToken,
+    apiVersion: config.shopify.apiVersion
+  });
+}
+async function liveCheckout({ config, items = [], client = clientFor(config) }) {
+  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));
+  const matching = checkouts.find((c2) => (c2.line_items ?? []).some((li) => wanted.has(Number(li.variant_id))));
+  const checkout = matching ?? checkouts[0];
+  return {
+    kind: "checkout",
+    url: checkout.abandoned_checkout_url,
+    cartValue: money2(checkout.total_price ?? 0).toFixed(2),
+    cartToken: checkout.cart_token,
+    lineItems: checkout.line_items ?? []
+  };
+}
+async function liveOrder({ config, items = [], phone, client = clientFor(config) }) {
+  const cust = config.customer ?? {};
+  const lineItems = items.map(({ variant, product, quantity }) => ({
+    variant_id: Number(variant?.id ?? product?.id),
+    quantity: Number(quantity) || 1
+  })).filter((li) => Number.isFinite(li.variant_id) && li.variant_id > 0);
+  if (lineItems.length === 0) return null;
+  const order = await client.createOrder({
+    line_items: lineItems,
+    financial_status: "paid",
+    email: cust.email || void 0,
+    phone: phone || cust.phone || void 0,
+    customer: cust.email || cust.firstName ? { first_name: cust.firstName, last_name: cust.lastName, email: cust.email } : void 0,
+    shipping_address: cust.address1 ? {
+      first_name: cust.firstName,
+      last_name: cust.lastName,
+      address1: cust.address1,
+      address2: cust.address2 || void 0,
+      city: cust.city,
+      province: cust.province,
+      country_code: cust.countryCode,
+      zip: cust.zip,
+      phone: phone || cust.phone || void 0
+    } : void 0,
+    tags: "hookwright",
+    note: "created by hookwright for webhook testing"
+  });
+  if (!order) return null;
+  return {
+    kind: "order",
+    id: Number(order.id),
+    number: Number(order.order_number),
+    name: order.name,
+    price: String(order.total_price ?? "0.00"),
+    currency: order.currency,
+    createdAt: order.created_at,
+    statusUrl: order.order_status_url
+  };
+}
+async function resolveLive({ config, providerId, eventName, items, phone, client }) {
+  if (!needsLive(providerId, eventName)) return null;
+  if (!config?.shopify?.domain || !config?.shopify?.accessToken) return null;
+  if (eventName === "checkout") return await liveCheckout({ config, items, ...client ? { client } : {} });
+  return await liveOrder({ config, items, phone, ...client ? { client } : {} });
+}
+
 // src/core/send.mjs
 import fs4 from "node:fs";
 import path4 from "node:path";
@@ -3107,7 +3227,9 @@ var STEP = {
   PICK: "pick",
   VARIANT: "variant",
   QUANTITY: "quantity",
+  DELTA: "delta",
   DISCOUNT: "discount",
+  LIVE: "live",
   MODE: "mode",
   FIELDS: "fields",
   BUILDING: "building",
@@ -3130,6 +3252,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({});
@@ -3163,6 +3287,9 @@ 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);
       case STEP.FIELDS:
@@ -3250,7 +3377,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;
     }
@@ -3306,27 +3434,40 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
     const nextItems = [...items, { product, variant: pendingVariant, quantity: qty }];
     advance(nextItems, cursor + 1);
   };
-  const startReview = (discount, chosenCollection = collection, chosenItems = items) => {
+  const startReview = async (discount, chosenCollection = collection, chosenItems = items, chosenDelta = delta) => {
     try {
+      let live = null;
+      if (needsLive(providerId, eventName)) {
+        setStep(STEP.LIVE);
+        live = await resolveLive({ config, providerId, eventName, items: chosenItems, phone: config.customer.phone });
+      }
       const next = draftPayload({
         cfg: config,
         providerId,
         items: chosenItems,
         discount,
         eventName,
-        collection: chosenCollection
+        collection: chosenCollection,
+        live,
+        delta: chosenDelta
       });
-      setDraft({ ...next, discount });
+      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 }).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 = "";
@@ -3400,6 +3541,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
       ) })
     ] }),
     step === STEP.LOADING && /* @__PURE__ */ jsx8(Spinner, { label: `fetching live products from ${store}\u2026` }),
+    step === STEP.LIVE && /* @__PURE__ */ jsx8(Spinner, { label: eventName === "checkout" ? `finding a real abandoned checkout in ${store}\u2026` : `creating a real order in ${store}\u2026` }),
     step === STEP.COLLECTION && /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx8(Text8, { children: "Which collection was viewed?" }),
       /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(
@@ -3445,6 +3587,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 `,
@@ -4570,10 +4730,19 @@ async function cmdBuild(args, config) {
   } else {
     log.ok(`${eventName} needs no product or collection`);
   }
+  let live = null;
+  if (needsLive(providerId, eventName)) {
+    log.step(eventName === "checkout" ? `finding a real abandoned checkout in ${config.shopify.domain}\u2026` : `creating a real order in ${config.shopify.domain}\u2026`);
+    live = await resolveLive({ config, providerId, eventName, items, phone: typeof args.flags.phone === "string" ? args.flags.phone : void 0 });
+    if (live?.kind === "checkout") log.ok(`checkout cart token ${live.cartToken}`);
+    else if (live?.kind === "order") log.ok(`order ${live.name} (${live.id})`);
+    else log.warn("no live record available \u2014 falling back to a generated one");
+  }
   const built = await buildPayload8({
     cfg: config,
     providerId,
     eventName,
+    live,
     collection,
     envelope: typeof args.flags.envelope === "string" ? args.flags.envelope : void 0,
     items,

package/package.json

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