hookwright 1.9.0 → 1.11.0

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.9.0",
+      version: "1.11.0",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -1142,7 +1142,6 @@ var EVENTS2 = [
   { eventName: "collection_page_viewed", type: "shopflo_collection_page_viewed", label: "Collection Page View", selection: "collection", subject: "one collection", envelope: "data" },
   { eventName: "product_page_viewed", type: "shopflo_product_page_viewed", label: "Product Page View", selection: "product", subject: "one product", envelope: "data" },
   { eventName: "added_to_cart_ui", type: "shopflo_added_to_cart", label: "Added To Cart", selection: "cart", subject: "cart contents", envelope: "root" },
-  { eventName: "checkout_clicked", type: "shopflo_checkout_clicked", label: "Checkout Clicked", selection: "cart", subject: "cart contents", envelope: "root" },
   { eventName: "checkout_abandoned", type: "shopflo_checkout_abandoned", label: "Abandoned Checkout", selection: "cart", subject: "cart contents", envelope: "root" },
   { eventName: "order_completed", type: "shopflo_order_completed", label: "Order Completed", selection: "cart", subject: "ordered items", envelope: "root" }
 ];
@@ -1156,33 +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: "storeUrl" },
+  { source: "session_id / sessionId", target: "sessionId" }
 ];
 var CART_FIELDS = [
-  { source: "line_items[].title", target: "cart.productName", required: true, note: "the first PAID line wins; freebies rank last" },
-  { source: "line_items[].product_image", target: "cart.image" },
+  { 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[].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[]", target: "cart.itemCount", note: "the line count, not the quantity" },
-  { source: "total_price", target: "pricing.totalPrice" },
-  { source: "subtotal_price", target: "pricing.subtotal" },
-  { source: "total_discount", target: "pricing.totalDiscount" },
-  { source: "currency", target: "pricing.currency" },
-  { source: "note_attributes[shopflo_checkout_url]", target: "checkoutUrl", note: "checkout_abandoned puts the link here, not in token_id" }
+  { 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" }
 ];
 var FIELD_MAPS2 = {
   store_page_view: [...COMMON_FIELDS2, ...BROWSING_FIELDS],
@@ -1198,7 +1201,6 @@ var FIELD_MAPS2 = {
     { source: "data.product_type", target: "product.type" }
   ],
   added_to_cart_ui: [...COMMON_FIELDS2, ...CART_FIELDS],
-  checkout_clicked: [...COMMON_FIELDS2, ...CART_FIELDS],
   checkout_abandoned: [...COMMON_FIELDS2, ...CART_FIELDS],
   order_completed: [
     ...COMMON_FIELDS2,
@@ -1311,7 +1313,7 @@ function buildPayload4(ctx) {
     title: product.title,
     price: money2(variant?.price ?? 0).toFixed(2),
     quantity,
-    product_image: imageForVariant(product, variant)
+    image: imageForVariant(product, variant)
   }));
   const subtotal = money2(lineItems.reduce((sum, li) => sum + Number(li.price) * li.quantity, 0));
   const discount = money2(Math.min(ctx.discount ?? 0, subtotal));
@@ -1320,17 +1322,38 @@ function buildPayload4(ctx) {
   return {
     event_name: eventName,
     session_id: ctx.sessionId ?? `sf-${now.getTime()}`,
-    token_id: checkoutUrl,
+    token_id: `sf-${now.getTime()}`,
+    abandoned_checkout_url: checkoutUrl,
     source: "shopflo",
     channel: "web",
     email: cust.email,
     phone,
     created_at: now.toISOString(),
-    // checkout_abandoned carries the recovery link here; the consumer prefers it
+    // the live note_attributes carry utm and the landing page, never a checkout url
     note_attributes: [
       { name: "landing_page", value: `/products/${items?.[0]?.product?.handle ?? ""}` },
-      { name: "shopflo_checkout_url", value: checkoutUrl }
+      { name: "utm_source", value: "ig" },
+      { name: "customer_type", value: "NEW" }
     ],
+    utm_params: {
+      utm_source: "ig",
+      utm_medium: "Instagram_Feed",
+      utm_campaign: "hookwright",
+      utm_content: "hookwright",
+      utm_term: "0",
+      landing_page: `/products/${items?.[0]?.product?.handle ?? ""}`,
+      landing_page_url: `https://${domain}/products/${items?.[0]?.product?.handle ?? ""}`
+    },
+    shipping_address: {
+      city: "Bangalore",
+      province: "Karnataka",
+      province_code: "KA",
+      zip: "560024",
+      country: "India",
+      country_code: "IN",
+      phone,
+      email: cust.email
+    },
     line_items: lineItems,
     customer: { uid: "sf-user", first_name: cust.firstName, last_name: cust.lastName, email: cust.email, phone },
     currency,
@@ -1360,7 +1383,7 @@ function webhookSecret4(config) {
 }
 function storeOf(payload) {
   const brandUrl = payload?.eventPayload?.clientData?.brandUrl;
-  const candidate = brandUrl ?? payload?.token_id;
+  const candidate = brandUrl ?? payload?.utm_params?.landing_page_url ?? payload?.data?.page_url;
   if (!candidate) return void 0;
   try {
     return new URL(candidate).host;
@@ -1494,7 +1517,19 @@ function nationalNumber(raw, regionCode) {
 // src/providers/flexype.mjs
 var GATE_PATH3 = "event_type";
 var GATE_VALUE2 = "ABANDONED_CHECKOUT";
+var EVENTS3 = [
+  { eventName: "ABANDONED_CHECKOUT", type: "flexype_abandoned_checkout", label: "Abandoned Checkout", selection: "cart", subject: "cart contents" },
+  { eventName: "COLLECTION_VIEWED", type: "flexype_collection_viewed", label: "Collection Viewed", selection: "collection", subject: "one collection" },
+  { eventName: "PRODUCT_VIEWED", type: "flexype_product_viewed", label: "Product Viewed", selection: "product", subject: "one product" }
+];
 var DEFAULT_EVENT3 = GATE_VALUE2;
+var eventDef2 = (eventName) => EVENTS3.find((e) => e.eventName === eventName) ?? EVENTS3[0];
+function eventFromPayload3(payload) {
+  return payload?.event_type;
+}
+function selectionFor3(eventName) {
+  return eventDef2(eventName).selection;
+}
 var fieldMap5 = [
   { source: "event_type", target: "\xABgate\xBB", required: true, note: "must be ABANDONED_CHECKOUT or the event is dropped" },
   { source: "payload.user.phone_with_dial_code", target: "phone", required: true, note: "falls back to dial_code + phone" },
@@ -1524,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" },
@@ -1541,12 +1613,64 @@ var editableFields5 = [
   { group: "Attribution", path: "payload.metadata.landing_page", label: "Landing page", optional: true }
 ];
 function buildPayload5(ctx) {
-  const { config, items, phone, live } = ctx;
+  const { config, items, phone, live, collection } = ctx;
+  const eventName = ctx.eventName ?? DEFAULT_EVENT3;
   const now = ctx.now ?? /* @__PURE__ */ new Date();
   const currency = ctx.currency || config.defaults.currency;
   const domain = config.shopify.domain;
   const cust = config.customer;
   const { dialCode, national } = splitPhone(phone, cust.countryCode);
+  const envelope = {
+    event_id: `fx-${now.getTime()}`,
+    event_type: eventName,
+    event_time: now.toISOString(),
+    store: {
+      id: 1,
+      name: config.shopify.shop?.name ?? config.shopify.domain,
+      shopify_domain: config.shopify.domain,
+      main_domain: config.shopify.domain
+    }
+  };
+  const user = {
+    email: config.customer.email,
+    full_name: `${config.customer.firstName} ${config.customer.lastName}`.trim(),
+    first_name: config.customer.firstName,
+    last_name: config.customer.lastName,
+    dial_code: splitPhone(phone, config.customer.countryCode).dialCode,
+    phone: splitPhone(phone, config.customer.countryCode).national,
+    phone_with_dial_code: phone
+  };
+  if (eventName === "COLLECTION_VIEWED") {
+    return {
+      ...envelope,
+      payload: {
+        user,
+        collection_viewed: {
+          collection_id: Number(collection?.id) || 0,
+          name: collection?.title ?? "",
+          handle: collection?.handle ?? "",
+          image: collection?.image?.src ?? "",
+          timestamp: now.toISOString()
+        }
+      }
+    };
+  }
+  if (eventName === "PRODUCT_VIEWED") {
+    const first = items?.[0];
+    return {
+      ...envelope,
+      payload: {
+        user,
+        product_viewed: {
+          product_id: Number(first?.product?.id) || 0,
+          title: first?.product?.title ?? "",
+          handle: first?.product?.handle ?? "",
+          image: imageForVariant(first?.product, first?.variant) ?? "",
+          timestamp: now.toISOString()
+        }
+      }
+    };
+  }
   const cartItems = (items ?? []).map(({ product, variant, quantity }) => {
     const unit = money2(variant?.price ?? 0);
     return {
@@ -1638,11 +1762,16 @@ var flexype_default = {
   urlKey: "flexype",
   label: "FlexyPe",
   eventType: "flexype_abandoned_checkout",
+  events: EVENTS3,
   defaultEvent: DEFAULT_EVENT3,
+  gateFor: (eventName) => ({ path: GATE_PATH3, value: eventName }),
+  selectionFor: selectionFor3,
+  eventFromPayload: eventFromPayload3,
   gate: { path: GATE_PATH3, value: GATE_VALUE2 },
   signatureScheme: "static shared secret in the header (no body signature)",
   signatureHeader: "x-flexype-authorization",
   fieldMap: fieldMap5,
+  fieldMapFor,
   editableFields: editableFields5,
   buildPayload: buildPayload5,
   sign: sign5,
@@ -1654,7 +1783,7 @@ var flexype_default = {
 // src/providers/return-prime.mjs
 var STATUSES = ["requested", "approved", "received", "inspected", "rejected"];
 var titleCase = (v) => v.charAt(0).toUpperCase() + v.slice(1);
-var EVENTS3 = ["return", "exchange"].flatMap(
+var EVENTS4 = ["return", "exchange"].flatMap(
   (requestType) => STATUSES.map((status) => ({
     eventName: `${requestType}_${status}`,
     requestType,
@@ -1666,14 +1795,14 @@ var EVENTS3 = ["return", "exchange"].flatMap(
   }))
 );
 var DEFAULT_EVENT4 = "return_requested";
-var eventDef2 = (eventName) => EVENTS3.find((e) => e.eventName === eventName) ?? EVENTS3.find((e) => e.eventName === DEFAULT_EVENT4);
-function eventFromPayload3(payload) {
+var eventDef3 = (eventName) => EVENTS4.find((e) => e.eventName === eventName) ?? EVENTS4.find((e) => e.eventName === DEFAULT_EVENT4);
+function eventFromPayload4(payload) {
   const request = payload?.request ?? payload ?? {};
   if (!request.request_type || !request.status) return void 0;
   return `${request.request_type}_${request.status}`;
 }
-function selectionFor3(eventName) {
-  return eventDef2(eventName).selection;
+function selectionFor4(eventName) {
+  return eventDef3(eventName).selection;
 }
 var COMMON_FIELDS3 = [
   { source: "request_type", target: "\xABgate\xBB + requestType", required: true, note: "return or exchange" },
@@ -1698,11 +1827,11 @@ 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) {
-  return eventDef2(eventName).requestType === "exchange" ? [...COMMON_FIELDS3, ...EXCHANGE_FIELDS] : COMMON_FIELDS3;
+function fieldMapFor2(eventName) {
+  return eventDef3(eventName).requestType === "exchange" ? [...COMMON_FIELDS3, ...EXCHANGE_FIELDS] : COMMON_FIELDS3;
 }
 function editableFieldsFor3(eventName) {
-  const def = eventDef2(eventName);
+  const def = eventDef3(eventName);
   const p = (path6) => def.envelope === "root" ? path6 : `request.${path6}`;
   return [
     { group: "Request", path: p("request_number"), label: "Request number" },
@@ -1728,7 +1857,7 @@ function statusBlock(reached, at, comment = null) {
 function buildPayload6(ctx) {
   const { config, items, phone } = ctx;
   const eventName = ctx.eventName ?? DEFAULT_EVENT4;
-  const def = eventDef2(eventName);
+  const def = eventDef3(eventName);
   const now = ctx.now ?? /* @__PURE__ */ new Date();
   const currency = ctx.currency || config.defaults.currency;
   const cust = config.customer;
@@ -1930,19 +2059,19 @@ var return_prime_default = {
   id: "return-prime",
   urlKey: "return_prime",
   label: "Return Prime",
-  events: EVENTS3,
+  events: EVENTS4,
   defaultEvent: DEFAULT_EVENT4,
   eventType: "return_prime_return_requested",
   gate: { path: "request.request_type", value: "return" },
-  gateFor: (eventName) => ({ path: "request.status", value: eventDef2(eventName).status }),
+  gateFor: (eventName) => ({ path: "request.status", value: eventDef3(eventName).status }),
   signatureScheme: "none documented \u2014 every request is accepted",
   signatureHeader: null,
   fieldMap: fieldMap6,
-  fieldMapFor,
+  fieldMapFor: fieldMapFor2,
   editableFields: editableFields6,
   editableFieldsFor: editableFieldsFor3,
-  selectionFor: selectionFor3,
-  eventFromPayload: eventFromPayload3,
+  selectionFor: selectionFor4,
+  eventFromPayload: eventFromPayload4,
   buildPayload: buildPayload6,
   sign: sign6,
   webhookUrl: webhookUrl6,
@@ -2830,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.9.0",
+  "version": "1.11.0",
   "description": "Build real, signed e-commerce webhooks from a live Shopify catalogue — interactive terminal UI, no backend",
   "keywords": [
     "webhook",