hookwright 1.10.0 → 1.12.0

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.10.0",
+      version: "1.12.0",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -1155,37 +1155,37 @@ function selectionFor2(eventName) {
 }
 var COMMON_FIELDS2 = [
   { source: "event_name / eventName", target: "\xABgate\xBB", required: true, note: "the schema matches EITHER spelling" },
-  { source: "customer.phone / user_data.phone", target: "customer.phone", required: true, note: "missing phone is rejected on every event" },
-  { source: "customer.first_name / user_data.firstName", target: "customer.firstName" },
-  { source: "customer.last_name / user_data.lastName", target: "customer.lastName" },
+  { source: "customer.phone / phone / data.user_data.phone / eventPayload.userData.phone", target: "customer.phone", required: true, note: "missing phone is rejected on every event" },
+  { source: "customer.first_name / data.user_data.firstName / eventPayload.userData.firstName", target: "customer.firstName" },
+  { source: "customer.last_name / data.user_data.lastName / eventPayload.userData.lastName", target: "customer.lastName" },
   { source: "\u2014 (first + last)", target: "customer.fullName", note: "built by the consumer, not sent" },
-  { source: "customer.email / user_data.email", target: "customer.email" },
+  { source: "customer.email / email / data.user_data.email / eventPayload.userData.email", target: "customer.email" },
   { source: "channel", target: "channel" },
   { source: "timestamp / created_at", target: "eventTime" }
 ];
 var BROWSING_FIELDS = [
-  { source: "uiData.pageUrl / data.page_url", target: "page.url" },
-  { source: "uiData.pageTitle / data.page_title", target: "page.title" },
-  { source: "uiData.landingPageUrl", target: "page.landingPage" },
-  { source: "uiData.referrerPageUrl", target: "page.referrer" },
-  { source: "clientData.brandUrl", target: "storeUrl" },
-  { source: "session_id", target: "sessionId" }
+  { source: "eventPayload.uiData.pageUrl / data.page_url", target: "page.url" },
+  { source: "eventPayload.uiData.pageTitle / data.page_title", target: "page.title" },
+  { source: "eventPayload.uiData.landingPageUrl / data.landing_page_url", target: "page.landingPage" },
+  { source: "eventPayload.uiData.referrerPageUrl / data.referrer_page_url", target: "page.referrer" },
+  { source: "eventPayload.clientData.brandUrl", target: "store_url" },
+  { source: "session_id / sessionId", target: "sessionId" }
 ];
 var CART_FIELDS = [
-  { source: "line_items[].title", target: "cart.productDetails", required: true, note: "the first PAID line wins; freebies rank last" },
-  { source: "line_items[].title", target: "cart.productName", note: 'the featured line alone, without the "and N more"' },
-  { source: "line_items[].image", target: "cart.image", note: "looked up from product_id when the line has none" },
-  { source: "\u2014 (store domain + handle)", target: "cart.productUrl", note: "resolved, not sent" },
-  { source: "\u2014 (store domain + line ids)", target: "cartLink", note: "resolved, not sent" },
-  { source: "\u2014 (company shopify integration)", target: "storeUrl", note: "resolved, not sent" },
+  { source: "line_items[].title", target: "product_details", required: true, note: "the first PAID line wins; freebies rank last" },
+  { source: "line_items[].title", target: "product_name", note: 'the featured line alone, without the "and N more"' },
+  { source: "line_items[].image", target: "product_image_url", note: "looked up from product_id when the line has none" },
+  { source: "\u2014 (store domain + handle)", target: "product_url", note: "resolved, not sent" },
+  { source: "\u2014 (store domain + line ids)", target: "cart_link", note: "resolved, not sent" },
+  { source: "\u2014 (company shopify integration)", target: "store_url", note: "resolved, not sent" },
   { source: "line_items[].price", target: "\u2014 (ranking only)", note: "a zero price marks the line a freebie" },
-  { source: "line_items[].quantity", target: "cart.quantity", note: "summed across the cart" },
+  { source: "line_items[].quantity", target: "total_quantity", note: "summed across the cart" },
   { source: "line_items[]", target: "cart.itemCount", note: "the line count, not the quantity" },
   { source: "total_price", target: "total_price", note: "the body is stored as sent" },
   { source: "subtotal_price", target: "subtotal_price" },
   { source: "total_discount", target: "total_discount" },
   { source: "currency", target: "currency" },
-  { source: "abandoned_checkout_url", target: "checkoutUrl", required: true, note: "token_id is a bare uuid, only usable once built into a link" }
+  { source: "abandoned_checkout_url", target: "checkout_link", required: true, note: "token_id is a bare uuid, only usable once built into a link" }
 ];
 var FIELD_MAPS2 = {
   store_page_view: [...COMMON_FIELDS2, ...BROWSING_FIELDS],
@@ -1537,21 +1537,21 @@ var fieldMap5 = [
   { source: "payload.user.last_name", target: "customer.lastName" },
   { source: "payload.user.full_name", target: "customer.fullName", note: "falls back to first + last name" },
   { source: "payload.user.email", target: "customer.email" },
-  { source: "payload.checkout_url", target: "checkoutUrl", required: true },
+  { source: "payload.checkout_url", target: "payload.checkout_url", required: true },
   { source: "payload.session_id", target: "sessionId" },
   { source: "payload.session_state", target: "sessionState" },
-  { source: "payload.cart_items[].title", target: "cart.productName", required: true, note: "the first PAID line wins; freebies rank last" },
-  { source: "payload.cart_items[].image", target: "cart.image" },
-  { source: "payload.cart_items[].total_price", target: "pricing.totalPrice", note: "summed across the cart" },
-  { source: "payload.cart_items[].total_discount", target: "pricing.totalDiscount", note: "summed across the cart" },
-  { source: "payload.cart_items[].quantity", target: "cart.quantity", note: "summed across the cart" },
+  { source: "payload.cart_items[].title", target: "product_details", required: true, note: "the first PAID line wins; freebies rank last" },
+  { source: "payload.cart_items[].image", target: "product_image_url" },
+  { source: "payload.cart_items[].total_price", target: "total_price", note: "summed across the cart" },
+  { source: "payload.cart_items[].total_discount", target: "total_discount", note: "summed across the cart" },
+  { source: "payload.cart_items[].quantity", target: "total_quantity", note: "summed across the cart" },
   { source: "payload.cart_items[]", target: "cart.itemCount", note: "the line count, not the quantity" },
-  { source: "payload.coupons[0].code", target: "pricing.couponCode" },
-  { source: "payload.checkout_context.presentment_currency", target: "pricing.currency" },
+  { source: "payload.coupons[0].code", target: "coupon_code" },
+  { source: "payload.checkout_context.presentment_currency", target: "currency" },
   { source: "payload.checkout_context.presentment_country", target: "phone region" },
   { source: "payload.metadata.utm[]", target: "utm.*", note: "a list of {name,value} pairs, not an object" },
   { source: "payload.metadata.landing_page", target: "attribution.landingPage" },
-  { source: "store.shopify_domain", target: "storeUrl" },
+  { source: "store.shopify_domain", target: "store.shopify_domain" },
   { source: "store.name", target: "store.name" },
   { source: "store.main_domain", target: "store.mainDomain" },
   { source: "payload.checkout_context.store_country", target: "store.country" },
@@ -1559,6 +1559,43 @@ var fieldMap5 = [
   { source: "event_id", target: "eventId" },
   { source: "event_time", target: "eventTime" }
 ];
+var ENVELOPE_FIELDS = [
+  { source: "event_type", target: "\xABgate\xBB", required: true, note: "the schema matches on this" },
+  { source: "payload.user.phone_with_dial_code", target: "customer.phone", required: true, note: "falls back to dial_code + phone" },
+  { source: "payload.user.first_name", target: "customer.firstName" },
+  { source: "payload.user.last_name", target: "customer.lastName" },
+  { source: "payload.user.full_name", target: "customer.fullName", note: "falls back to first + last name" },
+  { source: "payload.user.email", target: "customer.email" },
+  { source: "store.shopify_domain", target: "store.shopify_domain" },
+  { source: "store.name", target: "store.name" },
+  { source: "store.main_domain", target: "store.main_domain" },
+  { source: "event_id", target: "eventId" },
+  { source: "event_time", target: "eventTime" }
+];
+var COLLECTION_VIEWED_FIELDS = [
+  ...ENVELOPE_FIELDS,
+  { source: "payload.collection_viewed.name", target: "payload.collection_viewed.name", required: true },
+  { source: "payload.collection_viewed.handle", target: "payload.collection_viewed.handle", required: true, note: "the url is built from this" },
+  { source: "payload.collection_viewed.image", target: "payload.collection_viewed.image" },
+  { source: "payload.collection_viewed.collection_id", target: "payload.collection_viewed.collection_id" },
+  { source: "\u2014 (store domain + handle)", target: "collection_url", note: "derived, not sent" }
+];
+var PRODUCT_VIEWED_FIELDS = [
+  ...ENVELOPE_FIELDS,
+  { source: "payload.product_viewed.title", target: "payload.product_viewed.title", required: true },
+  { source: "payload.product_viewed.handle", target: "payload.product_viewed.handle", required: true, note: "the url is built from this" },
+  { source: "payload.product_viewed.image", target: "payload.product_viewed.image" },
+  { source: "payload.product_viewed.product_id", target: "payload.product_viewed.product_id" },
+  { source: "\u2014 (store domain + handle)", target: "product_url", note: "derived, not sent" }
+];
+var FIELD_MAPS3 = {
+  ABANDONED_CHECKOUT: fieldMap5,
+  COLLECTION_VIEWED: COLLECTION_VIEWED_FIELDS,
+  PRODUCT_VIEWED: PRODUCT_VIEWED_FIELDS
+};
+function fieldMapFor(eventName) {
+  return FIELD_MAPS3[eventName] ?? fieldMap5;
+}
 var editableFields5 = [
   { group: "Event", path: "event_id", label: "Event id" },
   { group: "Event", path: "event_time", label: "Event time" },
@@ -1734,6 +1771,7 @@ var flexype_default = {
   signatureScheme: "static shared secret in the header (no body signature)",
   signatureHeader: "x-flexype-authorization",
   fieldMap: fieldMap5,
+  fieldMapFor,
   editableFields: editableFields5,
   buildPayload: buildPayload5,
   sign: sign5,
@@ -1789,7 +1827,7 @@ var EXCHANGE_FIELDS = [
   { source: "line_items[].exchange_product.price", target: "exchangeProduct.price + pricing.priceDifference", note: "difference is signed: positive means the shopper owes more" }
 ];
 var fieldMap6 = COMMON_FIELDS3;
-function fieldMapFor(eventName) {
+function fieldMapFor2(eventName) {
   return eventDef3(eventName).requestType === "exchange" ? [...COMMON_FIELDS3, ...EXCHANGE_FIELDS] : COMMON_FIELDS3;
 }
 function editableFieldsFor3(eventName) {
@@ -2029,7 +2067,7 @@ var return_prime_default = {
   signatureScheme: "none documented \u2014 every request is accepted",
   signatureHeader: null,
   fieldMap: fieldMap6,
-  fieldMapFor,
+  fieldMapFor: fieldMapFor2,
   editableFields: editableFields6,
   editableFieldsFor: editableFieldsFor3,
   selectionFor: selectionFor4,
@@ -2921,9 +2959,30 @@ function checkAllowedPhone(payload, config) {
     detail: ok ? `${normalized} is an approved test handset` : `${normalized} is NOT in allowedPhones \u2014 refusing to risk messaging a real shopper`
   };
 }
+function resolveSource(payload, source) {
+  for (const candidate of String(source).split(" / ")) {
+    const path6 = candidate.trim();
+    if (!path6 || path6.startsWith("\u2014")) continue;
+    if (path6.includes("[]")) {
+      const [listPath, ...rest] = path6.split("[]");
+      const list = getPath(payload, listPath);
+      if (!Array.isArray(list)) continue;
+      const leaf = rest.join("").replace(/^\./, "");
+      const hit = list.find((item) => {
+        const v = leaf ? getPath(item, leaf) : item;
+        return v !== void 0 && v !== null && v !== "";
+      });
+      if (hit !== void 0) return leaf ? getPath(hit, leaf) : hit;
+      continue;
+    }
+    const value = getPath(payload, path6);
+    if (value !== void 0 && value !== null && value !== "") return value;
+  }
+  return void 0;
+}
 function coverage(payload, fieldMap8) {
   return fieldMap8.map((f) => {
-    const value = getPath(payload, f.source);
+    const value = resolveSource(payload, f.source);
     const present = value !== void 0 && value !== null && value !== "";
     return {
       field: f.source,

package/package.json

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