hookwright 1.2.0 → 1.2.2

package/README.md

@@ -94,7 +94,7 @@ A generated payload is useless if the receiver silently drops it, so every build
 - **JSON round-trip** — receivers that verify `HMAC(secret, timestamp + JSON.stringify(parsedBody))` can only match if `JSON.stringify(JSON.parse(raw)) === raw`. If it doesn't, you're told the exact byte offset.
 - **Phone** — parsed to E.164 using the shipping `country_code`, the same way the consumer does.
 - **Phone allow-list** — refuses to build for a number that isn't an approved test handset, so a live shopper can never be messaged by a test run.
-- **Product images** — every `image_url` is `HEAD`-checked; unreachable images fail the build.
+- **Product images** — every `image_url` is `HEAD`-checked. A product with no image warns rather than blocking: the message simply renders without one.
 - **Endpoint exists** — before a signed payload is handed over, the destination is verified: the hostname must resolve, something must accept a TCP connection on the port, and the path must not 404. A typo'd host is caught here instead of looking like a silent delivery failure. The probe is `OPTIONS`, falling back to `HEAD` — **never a POST and never a body**, so it cannot create data on the receiving system. Timeouts and servers that reject `OPTIONS` warn rather than block. Skip with `--no-endpoint-check`, override with `--force`.
 - **Field coverage** — a table of every field the consumer reads, what it maps to, and its value. Missing required fields are flagged in red.
 
@@ -142,7 +142,7 @@ Adding one is a single file in `src/providers/` exporting `buildPayload`, `sign`
 ```bash
 npm install
 npm run dev     # esbuild watch
-npm test        # 185 tests, no network required
+npm test        # 190 tests, no network required
 npm start       # build + run
 ```
 

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.2.0",
+      version: "1.2.2",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -449,7 +449,7 @@ var fieldMap = [
   { source: "data.customer.shipping_address.zip", target: "customer.zip" },
   { source: "data.line_items[0].name", target: "cart.productName", required: true },
   { source: "data.line_items[0].currency", target: "pricing.currency", required: true, note: "currency is read off the FIRST line item, not the root" },
-  { source: "data.line_items[0].image_url", target: "cart.image", required: true, note: "first line item with an image wins" },
+  { source: "data.line_items[0].image_url", target: "cart.image", note: "first line item with an image wins; blank if the product has none" },
   { source: "data.line_items[0].quantity", target: "cart.quantity" },
   { source: "data.utm_parameters.utm_source", target: "utm.source" },
   { source: "data.utm_parameters.utm_medium", target: "utm.medium" },
@@ -621,7 +621,7 @@ var fieldMap2 = [
   { source: "customer.Shipping_address.Country_code", target: "customer.countryCode", required: true, note: "region used to parse the phone" },
   { source: "customer.Shipping_address.Zip", target: "customer.zip" },
   { source: "line_items[0].name", target: "cart.productName", required: true },
-  { source: "line_items[0].image_url", target: "cart.image", required: true },
+  { source: "line_items[0].image_url", target: "cart.image", note: "blank if the product has no image" },
   { source: "line_items[0].quantity", target: "cart.quantity" }
 ];
 var editableFields2 = [
@@ -776,6 +776,9 @@ var EVENTS = [
   { eventName: "orders/create", type: "nitro_orders_create", label: "Order Created", selection: "cart", subject: "ordered items" },
   { eventName: "orders/updated", type: "nitro_orders_updated", label: "Order Updated", selection: "cart", subject: "ordered items" }
 ];
+function eventFromPayload(payload) {
+  return payload?.eventName;
+}
 function selectionFor(eventName) {
   return EVENTS.find((e) => e.eventName === eventName)?.selection ?? "cart";
 }
@@ -805,7 +808,7 @@ var FIELD_MAPS = {
     ...COMMON_FIELDS,
     ...PAGE_FIELDS,
     { source: "eventVal.title", target: "eventVal.title", required: true },
-    { source: "eventVal.image", target: "eventVal.image", required: true },
+    { source: "eventVal.image", target: "eventVal.image", note: "blank if the product has no image" },
     { source: "eventVal.price", target: "eventVal.price", required: true },
     { source: "eventVal.resource_id", target: "eventVal.resource_id", required: true },
     { source: "eventVal.resource", target: "eventVal.resource" },
@@ -1061,6 +1064,7 @@ var nitro_default = {
   editableFields: editableFields3,
   editableFieldsFor,
   selectionFor,
+  eventFromPayload,
   buildPayload: buildPayload3,
   sign: sign3,
   webhookUrl: webhookUrl3,
@@ -1773,10 +1777,11 @@ async function checkImages(payload, { timeoutMs = 1e4 } = {}) {
   }));
 }
 async function runAll({ payload, body, provider, config, checkImageUrls = true, checkEndpoint = true, eventName }) {
-  const checks = [checkGate(payload, provider, eventName), checkRoundTrip(body), checkPhone(payload), checkAllowedPhone(payload, config)];
+  const event = eventName ?? (provider.eventFromPayload ? provider.eventFromPayload(payload) : void 0);
+  const checks = [checkGate(payload, provider, event), checkRoundTrip(body), checkPhone(payload), checkAllowedPhone(payload, config)];
   if (checkImageUrls) checks.push(...await checkImages(payload));
   if (checkEndpoint) checks.push(await checkEndpointExists(provider.webhookUrl(config)));
-  const fields = eventName && provider.fieldMapFor ? provider.fieldMapFor(eventName) : provider.fieldMap;
+  const fields = event && provider.fieldMapFor ? provider.fieldMapFor(event) : provider.fieldMap;
   const cov = coverage(payload, fields);
   const missing = cov.filter((c2) => c2.status === "MISSING");
   checks.push({
@@ -1918,7 +1923,8 @@ async function buildPayload4({ cfg, providerId = "cashfree-occ", items = [], dis
   };
   const file = savePayload({ provider: provider.id, payload, body, meta });
   audit("payload.built", { provider: provider.id, valid: report.ok, file });
-  return { provider, payload, body, report, file, meta, summary };
+  const record = { provider: provider.id, payload, body, meta };
+  return { provider, payload, body, report, file, meta, summary, record };
 }
 
 // src/core/send.mjs
@@ -2212,7 +2218,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         setStep(STEP.COLLECTION);
       }).catch((err) => {
         if (alive) {
-          setError({ message: err.message, hint: err.hint });
+          setError({ message: err.message, hint: err.hint, failures: err.failures });
           setStep(STEP.ERROR);
         }
       });
@@ -2231,7 +2237,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
       setStep(STEP.PICK);
     }).catch((err) => {
       if (!alive) return;
-      setError({ message: err.message, hint: err.hint });
+      setError({ message: err.message, hint: err.hint, failures: err.failures });
       setStep(STEP.ERROR);
     });
     return () => {
@@ -2310,7 +2316,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
       setDraft({ ...next, discount });
       setStep(STEP.MODE);
     } catch (err) {
-      setError({ message: err.message, hint: err.hint });
+      setError({ message: err.message, hint: err.hint, failures: err.failures });
       setStep(STEP.ERROR);
     }
   };
@@ -2334,7 +2340,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
       }
       setStep(STEP.REPORT);
     }).catch((err) => {
-      setError({ message: err.message, hint: err.hint });
+      setError({ message: err.message, hint: err.hint, failures: err.failures });
       setStep(STEP.ERROR);
     });
   };
@@ -2356,11 +2362,11 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
   };
   const doSend = () => {
     setStep(STEP.SENDING);
-    dispatch({ cfg: config, record: { provider: built.provider.id, payload: built.payload, body: built.body } }).then((result) => {
+    dispatch({ cfg: config, record: built.record }).then((result) => {
       setSendResult(result);
       setStep(STEP.RESULT);
     }).catch((err) => {
-      setError({ message: err.message, hint: err.hint });
+      setError({ message: err.message, hint: err.hint, failures: err.failures });
       setStep(STEP.ERROR);
     });
   };
@@ -2594,6 +2600,11 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
     ] }),
     step === STEP.ERROR && error && /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx8(Alert, { variant: "error", children: error.message }),
+      error.failures?.length ? /* @__PURE__ */ jsx8(Box8, { flexDirection: "column", marginTop: 1, children: error.failures.map((f, i) => /* @__PURE__ */ jsxs8(Box8, { children: [
+        /* @__PURE__ */ jsx8(Text8, { color: palette.bad, children: ` ${glyph.cross} ` }),
+        /* @__PURE__ */ jsx8(Text8, { bold: true, children: `${f.name}: ` }),
+        /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: f.detail })
+      ] }, i)) }) : null,
       error.hint ? /* @__PURE__ */ jsx8(Text8, { color: palette.warn, children: `  ${error.hint}` }) : null,
       /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: "press enter to return to the menu" }) })
     ] })
@@ -3581,7 +3592,7 @@ async function cmdBuild(args, config) {
 async function cmdSend(args, config, built) {
   const bad = requireConfig(config);
   if (bad) return bad;
-  let record = built ? { provider: built.provider.id, payload: built.payload, body: built.body } : null;
+  let record = built?.record ?? null;
   if (!record && typeof args.flags.file === "string") record = loadPayload(args.flags.file);
   if (!record) record = loadLast();
   if (!record) {

package/package.json

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