hookwright 1.2.3 → 1.4.0

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.2.3",
+      version: "1.4.0",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -171,7 +171,11 @@ var DEFAULT_CONFIG = {
   targets: {
     "cashfree-occ": { webhookUrl: "", webhookSecret: "" },
     "razorpay-magic": { webhookUrl: "", webhookSecret: "" },
-    nitro: { webhookUrl: "", webhookSecret: "" }
+    nitro: { webhookUrl: "", webhookSecret: "" },
+    shopflo: { webhookUrl: "", webhookSecret: "" },
+    flexype: { webhookUrl: "", webhookSecret: "" },
+    "return-prime": { webhookUrl: "", webhookSecret: "" },
+    fastrr: { webhookUrl: "", webhookSecret: "" }
   },
   customer: {
     firstName: "",
@@ -407,6 +411,9 @@ function cartPermalink(domain, items) {
 function money2(value) {
   return Math.round(Number(value) * 100) / 100;
 }
+function minor(value) {
+  return Math.round(Number(value) * 100);
+}
 function normalizeCollection(collection) {
   return {
     id: String(collection.id),
@@ -603,7 +610,7 @@ var fieldMap2 = [
   { source: "email", target: "email" },
   { source: "phone", target: "phone", required: true, note: "falls back to Shipping_address.Phone" },
   { source: "currency", target: "pricing.currency", required: true, note: "read from the ROOT, unlike Cashfree" },
-  { source: "line_items_total", target: "pricing.totalPrice", required: true, note: "documented as a STRING in paise \u2014 the consumer parseFloats it and divides by 100" },
+  { source: "line_items_total", target: "pricing.totalPrice", required: true, note: "a STRING in the smallest currency unit \u2014 the consumer parseFloats it and divides by 100" },
   { source: "platform", target: "\u2014", note: "documented root field" },
   { source: "utm_parameters", target: "\u2014", note: "documented root field" },
   { source: "customer.first_name", target: "customer.firstName" },
@@ -622,14 +629,15 @@ var fieldMap2 = [
   { 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", note: "blank if the product has no image" },
-  { source: "line_items[0].quantity", target: "cart.quantity" }
+  { source: "line_items[0].quantity", target: "cart.quantity" },
+  { source: "line_items[].price", target: "\u2014", note: "smallest currency unit, like line_items_total; the consumer reads no item price" }
 ];
 var editableFields2 = [
   { group: "Checkout", path: "abandoned_checkout_url", label: "Abandoned checkout URL", hint: "must be non-empty \u2014 this is the schema gate" },
   { group: "Checkout", path: "created_at", label: "Created at" },
   { group: "Checkout", path: "shop_id", label: "Shop domain" },
   { group: "Checkout", path: "cart_token", label: "Cart token" },
-  { group: "Pricing", path: "line_items_total", label: "Line items total (paise, string)", hint: "documented as a string; the consumer divides by 100" },
+  { group: "Pricing", path: "line_items_total", label: "Line items total (minor units, string)", hint: "paise for INR, cents for USD; the consumer divides by 100" },
   { group: "Pricing", path: "currency", label: "Currency" },
   { group: "Customer", path: "customer.first_name", label: "First name" },
   { group: "Customer", path: "customer.last_name", label: "Last name" },
@@ -652,7 +660,7 @@ function buildPayload2(ctx) {
   const domain = config.shopify.domain;
   const cust = config.customer;
   const lineItems = items.map(({ product, variant, quantity }) => {
-    const price = money2(variant?.price ?? 0);
+    const price = minor(variant?.price ?? 0);
     return {
       image_url: imageForVariant(product, variant),
       name: product.title,
@@ -670,9 +678,9 @@ function buildPayload2(ctx) {
       gram: "0"
     };
   });
-  const total = money2(lineItems.reduce((sum, li) => sum + li.price * li.quantity, 0));
-  const discount = money2(Math.min(ctx.discount ?? 0, total));
-  const net2 = money2(total - discount);
+  const total = lineItems.reduce((sum, li) => sum + li.price * li.quantity, 0);
+  const discount = Math.min(minor(ctx.discount ?? 0), total);
+  const net2 = total - discount;
   const checkoutUrl = cartPermalink(domain, items.map(({ variant, quantity }) => ({ variantId: variant?.id, quantity })));
   return {
     shop_id: domain,
@@ -684,9 +692,9 @@ function buildPayload2(ctx) {
     phone,
     abandoned_checkout_url: checkoutUrl,
     currency,
-    // Documented as a string, in the smallest currency unit (paise).
+    // Documented as a string, already in the smallest currency unit.
     // The consumer parses it with parseFloat and divides by 100.
-    line_items_total: String(Math.round(net2 * 100)),
+    line_items_total: String(net2),
     line_items: lineItems,
     tax_details: {},
     promotions: [],
@@ -743,7 +751,7 @@ function summarize2(payload) {
     items: items.map((i) => `${i.name} x${i.quantity}`).join(", "),
     total: Number.parseFloat(payload?.line_items_total ?? "0") / 100,
     currency: payload?.currency,
-    extra: `${payload?.line_items_total} paise`,
+    extra: `${payload?.line_items_total} minor units`,
     link: payload?.abandoned_checkout_url
   };
 }
@@ -801,7 +809,7 @@ var FIELD_MAPS = {
     ...PAGE_FIELDS,
     { source: "eventVal.resource_id", target: "eventVal.resource_id", required: true, note: "the collection id" },
     { source: "eventVal.resource", target: "eventVal.resource" },
-    { source: "eventVal.title", target: "collection name", required: true },
+    { source: "eventVal.resource_id", target: "collection lookup", required: true, note: "the consumer fetches the collection by this id" },
     { source: "eventVal.domain", target: "eventVal.domain" }
   ],
   product_view: [
@@ -820,7 +828,7 @@ var FIELD_MAPS = {
     { source: "eventVal.init_cart", target: "eventVal.init_cart" },
     { source: "eventVal.empty_cart", target: "eventVal.empty_cart" },
     { source: "eventVal.bik_customer_id", target: "eventVal.bik_customer_id" },
-    { source: "eventVal.line_items[0].name", target: "cart enrichment", required: true }
+    { source: "eventVal.line_items[0].title", target: "cart enrichment", required: true }
   ],
   removefromcart: [
     ...COMMON_FIELDS,
@@ -828,7 +836,7 @@ var FIELD_MAPS = {
     { source: "eventVal.init_cart", target: "eventVal.init_cart" },
     { source: "eventVal.empty_cart", target: "eventVal.empty_cart" },
     { source: "eventVal.bik_customer_id", target: "eventVal.bik_customer_id" },
-    { source: "eventVal.line_items[0].name", target: "cart enrichment" }
+    { source: "eventVal.line_items[0].title", target: "cart enrichment" }
   ],
   checkout: [
     ...COMMON_FIELDS,
@@ -867,7 +875,7 @@ var EDITABLE = {
   ],
   collection: [
     { group: "Collection", path: "eventVal.resource_id", label: "Collection id" },
-    { group: "Collection", path: "eventVal.title", label: "Collection name" },
+    { group: "Collection", path: "eventVal.resource_id", label: "Collection id", type: "number" },
     { group: "Collection", path: "eventVal.l", label: "Collection URL" }
   ],
   product: [
@@ -912,104 +920,102 @@ function buildPayload3(ctx) {
   const session = crypto3.randomBytes(8).toString("hex");
   const first = items[0];
   const lineItems = items.map(({ product, variant, quantity }) => ({
-    id: variant ? String(variant.id) : null,
-    product_id: String(product.id),
-    name: product.title,
-    title: product.title,
     quantity,
-    price: money2(variant?.price ?? 0),
-    image: imageForVariant(product, variant),
-    url: `https://${domain}/products/${product.handle ?? ""}`
+    title: product.title,
+    line_price: money2((variant?.price ?? 0) * quantity).toFixed(2),
+    id: Number(variant?.id ?? product.id),
+    product_id: Number(product.id),
+    image_url: imageForVariant(product, variant)
   }));
-  const cartValue = money2(lineItems.reduce((sum, li) => sum + li.price * li.quantity, 0));
-  const productUrl = first ? `https://${domain}/products/${first.product.handle ?? ""}` : `https://${domain}`;
+  const cartValue = money2(items.reduce((sum, i) => sum + money2(i.variant?.price ?? 0) * i.quantity, 0));
   const customer = {
-    phone,
     email: cust.email,
-    name: `${cust.firstName} ${cust.lastName}`.trim(),
-    first_name: cust.firstName,
-    last_name: cust.lastName
+    phone,
+    name: `${cust.firstName} ${cust.lastName}`.trim()
   };
+  const pageUrl = eventName === "product_view" ? `https://${domain}/products/${first?.product?.handle ?? ""}` : eventName === "category_view" ? `https://${domain}/collections/${ctx.collection?.handle ?? "all"}` : `https://${domain}/`;
+  const isBrowsing = ["view", "category_view", "product_view"].includes(eventName);
   const base = {
-    org_token: config.defaults.orgToken ?? crypto3.randomBytes(12).toString("hex"),
+    org_token: config.defaults.orgToken ?? crypto3.randomUUID(),
     eventName,
+    u: isBrowsing ? pageUrl : "",
+    lang: config.defaults.lang ?? "en",
     userId: crypto3.randomUUID(),
     timestamp: now.toISOString(),
     country: cust.countryCode,
-    domain
-  };
-  const page = {
-    page: eventName === "product_view" ? "product" : eventName === "category_view" ? "collection" : "home",
-    h: domain,
-    l: productUrl,
-    _ss: session,
-    domain
+    state: isBrowsing ? cust.province : null,
+    city: isBrowsing ? cust.city : null,
+    pincode: isBrowsing ? cust.zip : null
   };
   let eventVal;
   switch (eventName) {
     case "view":
-      eventVal = { page: "home", h: domain, l: `https://${domain}`, _ss: session, domain, customer };
+      eventVal = { page: pageUrl, h: domain, l: pageUrl, _ss: session, customer };
       break;
-    case "category_view": {
-      const collection = ctx.collection;
+    case "category_view":
       eventVal = {
-        ...page,
-        page: "collection",
-        resource: "collection",
-        resource_id: String(collection?.id ?? ""),
-        title: collection?.title,
-        image: collection?.image || void 0,
-        l: collection?.handle ? `https://${domain}/collections/${collection.handle}` : `https://${domain}/collections/all`,
+        page: pageUrl,
+        resource_id: ctx.collection?.id ? Number(ctx.collection.id) : null,
+        resource: ctx.collection?.id ? "collection" : null,
+        domain,
+        h: domain,
+        l: pageUrl,
+        _ss: session,
         customer
       };
       break;
-    }
     case "product_view":
       eventVal = {
-        ...page,
+        page: pageUrl,
+        resource_id: Number(first?.product?.id ?? 0),
         resource: "product",
-        resource_id: String(first?.product?.id ?? ""),
-        title: first?.product?.title,
-        image: first ? imageForVariant(first.product, first.variant) : void 0,
+        domain,
         price: money2(first?.variant?.price ?? 0),
+        h: domain,
+        l: pageUrl,
+        _ss: session,
+        image: first ? imageForVariant(first.product, first.variant) : void 0,
+        title: first?.product?.title,
         customer
       };
       break;
     case "addtocart":
-    case "removefromcart":
+    case "removefromcart": {
+      const added = eventName === "addtocart";
       eventVal = {
-        cart_value: cartValue,
-        init_cart: eventName === "addtocart",
-        empty_cart: eventName === "removefromcart" && items.length === 0,
-        bik_customer_id: crypto3.randomUUID(),
-        line_items: lineItems,
-        [eventName === "addtocart" ? "items_added" : "items_removed"]: lineItems,
-        customer
+        line_items: added ? lineItems : [],
+        cart_value: added ? cartValue : 0,
+        recent_product_image: added ? lineItems[0]?.image_url ?? null : null,
+        init_cart: false,
+        empty_cart: !added,
+        items_added: added ? lineItems : [],
+        items_removed: added ? [] : lineItems,
+        customer,
+        bik_customer_id: null
       };
       break;
+    }
     case "checkout":
       eventVal = {
         checkout: cartPermalink(domain, items.map(({ variant, quantity }) => ({ variantId: variant?.id, quantity }))),
-        cart_value: cartValue,
-        bik_customer_id: crypto3.randomUUID(),
-        line_items: lineItems,
-        customer
+        cart_value: cartValue.toFixed(2),
+        customer,
+        bik_customer_id: null
       };
       break;
     case "orders/create":
     case "orders/updated": {
       const orderNumber = 1e3 + Math.floor(Math.random() * 9e3);
       eventVal = {
-        url: `https://${domain}/admin/orders/${orderNumber}`,
-        order_id: String(Date.now()),
+        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,
-        order_name: `#${orderNumber}`,
-        price: cartValue,
+        order_name: crypto3.randomBytes(4).toString("hex").toUpperCase(),
+        price: cartValue.toFixed(2),
         currency,
         order_created_at: now.toISOString(),
-        bik_customer_id: crypto3.randomUUID(),
-        line_items: lineItems,
-        customer
+        customer,
+        bik_customer_id: null
       };
       break;
     }
@@ -1039,9 +1045,10 @@ function summarize3(payload) {
   const items = Array.isArray(ev.line_items) ? ev.line_items : [];
   return {
     event: payload?.eventName,
-    store: payload?.domain,
+    // the schema keeps the domain inside eventVal, not at the root
+    store: payload?.eventVal?.h ?? payload?.eventVal?.domain,
     customer: `${ev.customer?.name ?? ""} \xB7 ${ev.customer?.phone ?? ""}`.trim(),
-    items: items.map((i) => `${i.name} x${i.quantity}`).join(", ") || "\u2014",
+    items: items.map((i) => `${i.title} x${i.quantity}`).join(", ") || payload?.eventVal?.title || "\u2014",
     total: ev.cart_value ?? ev.price ?? void 0,
     currency: ev.currency,
     extra: ev.order_name ? `order ${ev.order_name}` : ev.checkout ? "checkout started" : "",
@@ -1072,6 +1079,981 @@ var nitro_default = {
   summarize: summarize3
 };
 
+// src/providers/shopflo.mjs
+var EVENTS2 = [
+  { eventName: "store_page_view", type: "shopflo_store_page_view", label: "Store Page View", selection: "none", subject: "a page, no product", envelope: "eventPayload" },
+  { 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" }
+];
+var DEFAULT_EVENT2 = "checkout_abandoned";
+var eventDef = (eventName) => EVENTS2.find((e) => e.eventName === eventName) ?? EVENTS2.find((e) => e.eventName === DEFAULT_EVENT2);
+function eventFromPayload2(payload) {
+  return payload?.event_name ?? payload?.eventName;
+}
+function selectionFor2(eventName) {
+  return eventDef(eventName).selection;
+}
+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: "phone", required: true, note: "missing phone is rejected on every event" }
+];
+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" }
+];
+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[].price", target: "\u2014 (ranking only)", note: "a zero price marks the line a freebie" },
+  { source: "line_items[].quantity", target: "cart.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" }
+];
+var FIELD_MAPS2 = {
+  store_page_view: [...COMMON_FIELDS2, ...BROWSING_FIELDS],
+  collection_page_viewed: [...COMMON_FIELDS2, ...BROWSING_FIELDS, { source: "data.collection_page_url", target: "collection.url" }],
+  product_page_viewed: [
+    ...COMMON_FIELDS2,
+    ...BROWSING_FIELDS,
+    { source: "data.product_name", target: "product.name" },
+    { source: "data.product_image", target: "product.image" },
+    { source: "data.product_url", target: "product.url" },
+    { source: "data.product_price", target: "product.price" }
+  ],
+  added_to_cart_ui: [...COMMON_FIELDS2, ...CART_FIELDS],
+  checkout_clicked: [...COMMON_FIELDS2, ...CART_FIELDS],
+  checkout_abandoned: [...COMMON_FIELDS2, ...CART_FIELDS],
+  order_completed: [
+    ...COMMON_FIELDS2,
+    ...CART_FIELDS,
+    { source: "order_id", target: "order.id" },
+    { source: "order_name", target: "order.name" },
+    { source: "payment_mode", target: "order.paymentMode" },
+    { source: "total_payable", target: "order.totalPayable" }
+  ]
+};
+var fieldMap4 = FIELD_MAPS2[DEFAULT_EVENT2];
+function editableFieldsFor2(eventName) {
+  const def = eventDef(eventName);
+  const base = [
+    { group: "Event", path: "session_id", label: "Session id" },
+    { group: "Customer", path: "customer.first_name", label: "First name" },
+    { group: "Customer", path: "customer.last_name", label: "Last name" },
+    { group: "Customer", path: "customer.email", label: "Email" },
+    { group: "Customer", path: "customer.phone", label: "Phone", hint: "must parse to E.164" }
+  ];
+  if (def.envelope === "eventPayload") {
+    return [
+      { group: "Event", path: "eventPayload.uiData.pageUrl", label: "Page URL" },
+      { group: "Event", path: "eventPayload.uiData.pageTitle", label: "Page title" },
+      { group: "Event", path: "eventPayload.clientData.brandUrl", label: "Store URL" },
+      { group: "Customer", path: "eventPayload.userData.firstName", label: "First name" },
+      { group: "Customer", path: "eventPayload.userData.email", label: "Email" },
+      { group: "Customer", path: "eventPayload.userData.phone", label: "Phone", hint: "must parse to E.164" }
+    ];
+  }
+  if (def.envelope === "data") {
+    return [
+      { group: "Event", path: "data.page_url", label: "Page URL" },
+      { group: "Event", path: "data.page_title", label: "Page title" },
+      { group: "Customer", path: "data.user_data.firstName", label: "First name" },
+      { group: "Customer", path: "data.user_data.email", label: "Email" },
+      { group: "Customer", path: "data.user_data.phone", label: "Phone", hint: "must parse to E.164" }
+    ];
+  }
+  return [
+    ...base,
+    { group: "Pricing", path: "total_price", label: "Total price", type: "number" },
+    { group: "Pricing", path: "subtotal_price", label: "Subtotal", type: "number" },
+    { group: "Pricing", path: "total_discount", label: "Discount", type: "number" },
+    { group: "Pricing", path: "currency", label: "Currency" },
+    ...def.eventName === "order_completed" ? [
+      { group: "Order", path: "order_name", label: "Order name" },
+      { group: "Order", path: "payment_mode", label: "Payment mode" },
+      { group: "Order", path: "total_payable", label: "Total payable", type: "number" }
+    ] : []
+  ];
+}
+var editableFields4 = editableFieldsFor2(DEFAULT_EVENT2);
+function buildPayload4(ctx) {
+  const { config, items, phone, collection } = ctx;
+  const eventName = ctx.eventName ?? DEFAULT_EVENT2;
+  const def = eventDef(eventName);
+  const now = ctx.now ?? /* @__PURE__ */ new Date();
+  const currency = ctx.currency || config.defaults.currency;
+  const domain = config.shopify.domain;
+  const cust = config.customer;
+  const first = items?.[0];
+  if (def.envelope === "eventPayload") {
+    return {
+      eventName,
+      session_id: ctx.sessionId ?? `sf-${now.getTime()}`,
+      channel: "web",
+      eventPayload: {
+        userData: { firstName: cust.firstName, lastName: cust.lastName, email: cust.email, phone },
+        uiData: {
+          pageUrl: `https://${domain}/`,
+          pageTitle: config.shopify.shop?.name ?? domain,
+          landingPageUrl: `https://${domain}/`,
+          referrerPageUrl: ""
+        },
+        clientData: { brandUrl: `https://${domain}` }
+      },
+      timestamp: now.getTime()
+    };
+  }
+  if (def.envelope === "data") {
+    const isProduct = def.selection === "product";
+    return {
+      event_name: eventName,
+      session_id: ctx.sessionId ?? `sf-${now.getTime()}`,
+      channel: "web",
+      data: {
+        page_url: isProduct ? `https://${domain}/products/${first?.product?.handle ?? ""}` : `https://${domain}/collections/${collection?.handle ?? "all"}`,
+        page_title: isProduct ? first?.product?.title : collection?.title,
+        landing_page_url: `https://${domain}/`,
+        referrer_page_url: "",
+        ...isProduct ? {
+          product_name: first?.product?.title,
+          product_image: imageForVariant(first?.product, first?.variant),
+          product_url: `https://${domain}/products/${first?.product?.handle ?? ""}`,
+          product_price: money2(first?.variant?.price ?? 0),
+          product_compare_at_price: money2(first?.variant?.compareAtPrice ?? first?.variant?.price ?? 0),
+          product_type: first?.product?.productType ?? ""
+        } : { collection_page_url: `https://${domain}/collections/${collection?.handle ?? "all"}` },
+        user_data: { firstName: cust.firstName, lastName: cust.lastName, email: cust.email, phone }
+      },
+      timestamp: now.getTime()
+    };
+  }
+  const lineItems = (items ?? []).map(({ product, variant, quantity }) => ({
+    id: String(variant?.id ?? product.id),
+    product_id: String(product.id),
+    title: product.title,
+    price: money2(variant?.price ?? 0).toFixed(2),
+    quantity,
+    product_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));
+  const total = money2(subtotal - discount);
+  const checkoutUrl = cartPermalink(domain, (items ?? []).map(({ variant, quantity }) => ({ variantId: variant?.id, quantity })));
+  return {
+    event_name: eventName,
+    session_id: ctx.sessionId ?? `sf-${now.getTime()}`,
+    token_id: checkoutUrl,
+    source: "shopflo",
+    channel: "web",
+    email: cust.email,
+    phone,
+    created_at: now.toISOString(),
+    // checkout_abandoned carries the recovery link here; the consumer prefers it
+    note_attributes: [
+      { name: "landing_page", value: `/products/${items?.[0]?.product?.handle ?? ""}` },
+      { name: "shopflo_checkout_url", value: checkoutUrl }
+    ],
+    line_items: lineItems,
+    customer: { uid: "sf-user", first_name: cust.firstName, last_name: cust.lastName, email: cust.email, phone },
+    currency,
+    subtotal_price: subtotal,
+    total_discount: discount,
+    total_price: total,
+    ...eventName === "order_completed" ? {
+      order_id: ctx.orderId ?? Math.floor(now.getTime() / 1e3),
+      order_name: ctx.orderName ?? `#${String(now.getTime()).slice(-5)}`,
+      payment_mode: "prepaid",
+      total_shipping: 0,
+      total_tax: 0,
+      total_payable: total
+    } : {},
+    timestamp: now.getTime()
+  };
+}
+function sign4() {
+  return { signature: null, timestamp: null, headers: { "content-type": "application/json" } };
+}
+function webhookUrl4(config) {
+  return String(targetFor(config, "shopflo").webhookUrl ?? "").trim();
+}
+function webhookSecret4(config) {
+  return String(targetFor(config, "shopflo").webhookSecret ?? "");
+}
+function storeOf(payload) {
+  const brandUrl = payload?.eventPayload?.clientData?.brandUrl;
+  const candidate = brandUrl ?? payload?.token_id;
+  if (!candidate) return void 0;
+  try {
+    return new URL(candidate).host;
+  } catch {
+    return candidate;
+  }
+}
+function summarize4(payload) {
+  const name = eventFromPayload2(payload);
+  const items = Array.isArray(payload?.line_items) ? payload.line_items : [];
+  const envelope = payload?.eventPayload ?? payload?.data ?? {};
+  const user = envelope?.userData ?? envelope?.user_data ?? payload?.customer ?? {};
+  return {
+    event: eventDef(name).label.toLowerCase(),
+    store: storeOf(payload),
+    customer: `${user.firstName ?? user.first_name ?? ""} ${user.lastName ?? user.last_name ?? ""} \xB7 ${payload?.phone ?? user.phone ?? ""}`.replace(/\s+/g, " ").trim(),
+    items: items.map((i) => `${i.title} x${i.quantity}`).join(", ") || (envelope?.product_name ?? "\u2014"),
+    total: payload?.total_price,
+    currency: payload?.currency,
+    extra: `envelope: ${eventDef(name).envelope}`,
+    link: payload?.note_attributes?.find((n) => n.name === "shopflo_checkout_url")?.value ?? payload?.token_id
+  };
+}
+var shopflo_default = {
+  id: "shopflo",
+  urlKey: "shopflo",
+  label: "Shopflo",
+  events: EVENTS2,
+  defaultEvent: DEFAULT_EVENT2,
+  eventType: "shopflo_checkout_abandoned",
+  gate: { path: "event_name", value: DEFAULT_EVENT2 },
+  gateFor: (eventName) => ({ path: eventDef(eventName).envelope === "eventPayload" ? "eventName" : "event_name", value: eventName }),
+  signatureScheme: "none documented \u2014 every request is accepted",
+  signatureHeader: null,
+  fieldMap: fieldMap4,
+  fieldMapFor: (eventName) => FIELD_MAPS2[eventName] ?? FIELD_MAPS2[DEFAULT_EVENT2],
+  editableFields: editableFields4,
+  editableFieldsFor: editableFieldsFor2,
+  selectionFor: selectionFor2,
+  eventFromPayload: eventFromPayload2,
+  buildPayload: buildPayload4,
+  sign: sign4,
+  webhookUrl: webhookUrl4,
+  webhookSecret: webhookSecret4,
+  summarize: summarize4
+};
+
+// src/phone.mjs
+var CALLING_CODES = {
+  IN: "91",
+  US: "1",
+  CA: "1",
+  GB: "44",
+  AE: "971",
+  SG: "65",
+  AU: "61",
+  NZ: "64",
+  DE: "49",
+  FR: "33",
+  IT: "39",
+  ES: "34",
+  NL: "31",
+  SE: "46",
+  RO: "40",
+  PL: "48",
+  ZA: "27",
+  NG: "234",
+  KE: "254",
+  BD: "880",
+  PK: "92",
+  LK: "94",
+  NP: "977",
+  MY: "60",
+  ID: "62",
+  PH: "63",
+  TH: "66",
+  VN: "84",
+  JP: "81",
+  KR: "82",
+  CN: "86",
+  SA: "966",
+  QA: "974",
+  KW: "965",
+  OM: "968",
+  BH: "973",
+  BR: "55",
+  MX: "52"
+};
+function callingCode(regionCode) {
+  return CALLING_CODES[String(regionCode || "").toUpperCase()] || null;
+}
+function toE164(raw, regionCode) {
+  const cleaned = String(raw ?? "").replace(/\s+/g, "");
+  if (!cleaned) return { ok: false, reason: "phone is empty" };
+  if (cleaned.startsWith("+")) {
+    const digits2 = cleaned.slice(1).replace(/\D/g, "");
+    if (digits2.length < 8 || digits2.length > 15) return { ok: false, reason: `+${digits2} is not a plausible E.164 length` };
+    return { ok: true, value: `+${digits2}` };
+  }
+  const cc = callingCode(regionCode);
+  if (!cc) {
+    return {
+      ok: false,
+      reason: `no country calling code known for region "${regionCode}" \u2014 give the phone in +E.164 form instead`
+    };
+  }
+  let national = cleaned.replace(/\D/g, "").replace(/^0+/, "");
+  if (national.startsWith(cc) && national.length > 10) national = national.slice(cc.length);
+  const value = `+${cc}${national}`;
+  const digits = value.slice(1);
+  if (digits.length < 8 || digits.length > 15) return { ok: false, reason: `${value} is not a plausible E.164 length` };
+  return { ok: true, value };
+}
+var knownRegions = Object.keys(CALLING_CODES);
+function splitPhone(raw, regionCode) {
+  const digits = String(raw ?? "").replace(/[^\d]/g, "");
+  if (!digits) return { dialCode: "", national: "" };
+  const fromRegion = callingCode(regionCode);
+  if (fromRegion && digits.startsWith(fromRegion)) {
+    return { dialCode: fromRegion, national: digits.slice(fromRegion.length) };
+  }
+  const longestFirst = [...new Set(Object.values(CALLING_CODES))].sort((a, b) => b.length - a.length);
+  const matched = longestFirst.find((code) => digits.startsWith(code));
+  if (matched) return { dialCode: matched, national: digits.slice(matched.length) };
+  return { dialCode: "", national: digits };
+}
+function nationalNumber(raw, regionCode) {
+  return splitPhone(raw, regionCode).national;
+}
+
+// src/providers/flexype.mjs
+var GATE_PATH3 = "event_type";
+var GATE_VALUE2 = "ABANDONED_CHECKOUT";
+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" },
+  { source: "payload.user.first_name", target: "customer.firstName" },
+  { source: "payload.user.last_name", target: "customer.lastName" },
+  { source: "payload.user.full_name", target: "customer.name" },
+  { source: "payload.user.email", target: "customer.email" },
+  { source: "payload.checkout_url", target: "checkoutUrl", 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" },
+  { source: "payload.coupons[0].code", target: "pricing.couponCode" },
+  { source: "payload.checkout_context.presentment_currency", target: "pricing.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.name", target: "store.name" },
+  { source: "event_id", target: "eventId" },
+  { source: "event_time", target: "eventTime" }
+];
+var editableFields5 = [
+  { group: "Event", path: "event_id", label: "Event id" },
+  { group: "Event", path: "event_time", label: "Event time" },
+  { group: "Checkout", path: "payload.session_id", label: "Session id" },
+  { group: "Checkout", path: "payload.checkout_url", label: "Checkout URL", hint: "the link the shopper is sent back to" },
+  { group: "Checkout", path: "payload.session_state", label: "Session state" },
+  { group: "Customer", path: "payload.user.first_name", label: "First name" },
+  { group: "Customer", path: "payload.user.last_name", label: "Last name" },
+  { group: "Customer", path: "payload.user.email", label: "Email" },
+  { group: "Customer", path: "payload.user.phone_with_dial_code", label: "Phone", hint: "already E.164 shaped" },
+  { group: "Pricing", path: "payload.checkout_context.presentment_currency", label: "Currency" },
+  { group: "Pricing", path: "payload.coupons.0.code", label: "Coupon code", optional: true },
+  { group: "Store", path: "store.name", label: "Store name" },
+  { group: "Store", path: "store.shopify_domain", label: "Shopify domain" },
+  { group: "Attribution", path: "payload.metadata.landing_page", label: "Landing page", optional: true }
+];
+function buildPayload5(ctx) {
+  const { config, items, phone } = ctx;
+  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 cartItems = (items ?? []).map(({ product, variant, quantity }) => {
+    const unit = money2(variant?.price ?? 0);
+    return {
+      title: product.title,
+      image: imageForVariant(product, variant),
+      price: unit,
+      total_price: money2(unit * quantity),
+      total_discount: 0,
+      quantity,
+      variant_id: String(variant?.id ?? ""),
+      product_id: String(product.id),
+      sku: variant?.sku || null
+    };
+  });
+  const checkoutUrl = cartPermalink(domain, (items ?? []).map(({ variant, quantity }) => ({ variantId: variant?.id, quantity })));
+  const utm = Object.entries(config.defaults.utm ?? {}).map(([name, value]) => ({ name, value }));
+  return {
+    event_id: `fx-${now.getTime()}`,
+    event_type: GATE_VALUE2,
+    event_time: now.toISOString(),
+    store: {
+      id: 1,
+      name: config.shopify.shop?.name ?? domain,
+      shopify_domain: domain,
+      main_domain: `https://${domain}`
+    },
+    payload: {
+      session_id: `fx-sess-${now.getTime()}`,
+      session_state: "ABANDONED",
+      checkout_url: checkoutUrl,
+      user: {
+        first_name: cust.firstName,
+        last_name: cust.lastName,
+        full_name: `${cust.firstName} ${cust.lastName}`.trim(),
+        email: cust.email,
+        phone: national,
+        dial_code: dialCode,
+        phone_with_dial_code: phone
+      },
+      checkout_context: {
+        presentment_currency: currency,
+        store_currency: currency,
+        presentment_country: cust.countryCode,
+        store_country: cust.country
+      },
+      cart_items: cartItems,
+      coupons: ctx.couponCode ? [{ code: ctx.couponCode }] : [],
+      metadata: {
+        landing_page: `https://${domain}/products/${items?.[0]?.product?.handle ?? ""}`,
+        orig_referer: "",
+        referer_host: "",
+        utm
+      }
+    }
+  };
+}
+function sign5({ secret }) {
+  return {
+    signature: null,
+    timestamp: null,
+    headers: {
+      "content-type": "application/json",
+      "x-flexype-authorization": String(secret ?? "")
+    }
+  };
+}
+function webhookUrl5(config) {
+  return String(targetFor(config, "flexype").webhookUrl ?? "").trim();
+}
+function webhookSecret5(config) {
+  return String(targetFor(config, "flexype").webhookSecret ?? "");
+}
+function summarize5(payload) {
+  const p = payload?.payload ?? {};
+  const items = Array.isArray(p.cart_items) ? p.cart_items : [];
+  return {
+    event: "abandoned checkout",
+    store: payload?.store?.shopify_domain,
+    customer: `${p.user?.full_name ?? ""} \xB7 ${p.user?.phone_with_dial_code ?? ""}`.trim(),
+    items: items.map((i) => `${i.title} x${i.quantity}`).join(", "),
+    total: items.reduce((sum, i) => sum + Number(i.total_price ?? 0), 0),
+    currency: p.checkout_context?.presentment_currency,
+    extra: p.coupons?.[0]?.code ? `coupon ${p.coupons[0].code}` : "no coupon",
+    link: p.checkout_url
+  };
+}
+var flexype_default = {
+  id: "flexype",
+  urlKey: "flexype",
+  label: "FlexyPe",
+  eventType: "flexype_abandoned_checkout",
+  gate: { path: GATE_PATH3, value: GATE_VALUE2 },
+  signatureScheme: "static shared secret in the header (no body signature)",
+  signatureHeader: "x-flexype-authorization",
+  fieldMap: fieldMap5,
+  editableFields: editableFields5,
+  buildPayload: buildPayload5,
+  sign: sign5,
+  webhookUrl: webhookUrl5,
+  webhookSecret: webhookSecret5,
+  summarize: summarize5
+};
+
+// 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(
+  (requestType) => STATUSES.map((status) => ({
+    eventName: `${requestType}_${status}`,
+    requestType,
+    status,
+    type: `return_prime_${requestType}_${status}`,
+    label: `${titleCase(requestType)} ${titleCase(status)}`,
+    selection: requestType === "exchange" ? "exchange" : "product",
+    subject: requestType === "exchange" ? "the returned product and its replacement" : "the returned product"
+  }))
+);
+var DEFAULT_EVENT3 = "return_requested";
+var eventDef2 = (eventName) => EVENTS3.find((e) => e.eventName === eventName) ?? EVENTS3.find((e) => e.eventName === DEFAULT_EVENT3);
+function eventFromPayload3(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;
+}
+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.*" }
+];
+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" }
+];
+var fieldMap6 = COMMON_FIELDS3;
+function fieldMapFor(eventName) {
+  return eventDef2(eventName).requestType === "exchange" ? [...COMMON_FIELDS3, ...EXCHANGE_FIELDS] : COMMON_FIELDS3;
+}
+function editableFieldsFor3(eventName) {
+  const def = eventDef2(eventName);
+  const p = (path6) => def.envelope === "root" ? path6 : `request.${path6}`;
+  return [
+    { group: "Request", path: p("request_number"), label: "Request number" },
+    { group: "Request", path: p("created_at"), label: "Created at" },
+    { group: "Request", path: p("line_items.0.reason"), label: "Reason" },
+    { group: "Order", path: p("order.name"), label: "Order name" },
+    { group: "Customer", path: p("customer.name"), label: "Customer name" },
+    { group: "Customer", path: p("customer.email"), label: "Email" },
+    { group: "Customer", path: p("customer.phone"), label: "Phone", hint: "already E.164 shaped" },
+    { group: "Shipping", path: p("customer.address.address_line_1"), label: "Address line 1" },
+    { group: "Shipping", path: p("customer.address.city"), label: "City" },
+    { group: "Shipping", path: p("customer.address.province"), label: "Province / state" },
+    { group: "Shipping", path: p("customer.address.postal_code"), label: "Postal code" },
+    { group: "Shipping", path: p("customer.address.country_code"), label: "Country code", hint: "region used to parse the phone" },
+    { group: "Pricing", path: p("line_items.0.presentment_price.actual_amount"), label: "Item amount", type: "number" },
+    { group: "Pricing", path: p("line_items.0.presentment_price.currency"), label: "Currency" }
+  ];
+}
+var editableFields6 = editableFieldsFor3(DEFAULT_EVENT3);
+function statusBlock(reached, at, comment = null) {
+  return { status: reached, comment, created_at: reached ? at : null };
+}
+function buildPayload6(ctx) {
+  const { config, items, phone } = ctx;
+  const eventName = ctx.eventName ?? DEFAULT_EVENT3;
+  const def = eventDef2(eventName);
+  const now = ctx.now ?? /* @__PURE__ */ new Date();
+  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 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 }
+      },
+      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 }
+      },
+      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 || "",
+        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: []
+  };
+  const request = {
+    id: `rp-${now.getTime()}`,
+    request_number: ctx.requestNumber ?? `${def.requestType === "exchange" ? "EXC" : "RET"}${String(now.getTime()).slice(-3)}`,
+    request_type: def.requestType,
+    status: def.status,
+    manual_request: false,
+    channel: 97426,
+    smart_exchange: false,
+    payment_details: null,
+    order: {
+      id: Number(ctx.orderId ?? String(now.getTime()).slice(-10)),
+      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 }],
+      created_at: at
+    },
+    customer: {
+      id: Number(String(now.getTime()).slice(-10)),
+      name: `${cust.firstName} ${cust.lastName}`.trim(),
+      email: cust.email,
+      phone,
+      address: {
+        first_name: cust.firstName,
+        last_name: cust.lastName || null,
+        postal_code: cust.zip,
+        city: cust.city,
+        province: cust.province,
+        country_code: cust.countryCode,
+        province_code: cust.provinceCode,
+        address_line_1: cust.address1,
+        address_line_2: cust.address2 ?? "",
+        country: cust.country,
+        address_line_3: ""
+      },
+      bank: { account_holder_name: "", account_number: "", confirm_account_number: "", ifsc_code: "" }
+    },
+    approved: statusBlock(reached("approved"), at),
+    received: statusBlock(reached("received"), at),
+    inspected: statusBlock(reached("inspected"), at, def.status === "inspected" ? "quickreply test" : null),
+    rejected: statusBlock(def.status === "rejected", at),
+    archived: statusBlock(false, at),
+    unarchived: statusBlock(false, at),
+    incentive: null,
+    line_items: [lineItem],
+    created_at: at
+  };
+  return ctx.envelope === "root" ? request : { request };
+}
+function sign6() {
+  return { signature: null, timestamp: null, headers: { "content-type": "application/json" } };
+}
+function webhookUrl6(config) {
+  return String(targetFor(config, "return-prime").webhookUrl ?? "").trim();
+}
+function webhookSecret6(config) {
+  return String(targetFor(config, "return-prime").webhookSecret ?? "");
+}
+function summarize6(payload) {
+  const r = payload?.request ?? payload ?? {};
+  const item = (Array.isArray(r.line_items) ? r.line_items : [])[0] ?? {};
+  const original = item.original_product ?? {};
+  const exchange = item.exchange_product;
+  const difference = exchange ? money2(Number(exchange.price ?? 0) - Number(original.price ?? 0)) : void 0;
+  return {
+    event: `${r.request_type ?? "?"} ${r.status ?? "?"}`,
+    store: item.return_location?.store ?? r.order?.name,
+    customer: `${r.customer?.name ?? ""} \xB7 ${r.customer?.phone ?? ""}`.trim(),
+    items: exchange ? `${original.title} \u2192 ${exchange.title}` : original.title,
+    total: item.presentment_price?.actual_amount,
+    currency: item.presentment_price?.currency,
+    extra: difference === void 0 ? `${r.request_number ?? ""}` : `difference ${difference > 0 ? "+" : ""}${difference} (${difference > 0 ? "shopper pays" : "refund due"})`,
+    link: null
+  };
+}
+var return_prime_default = {
+  id: "return-prime",
+  urlKey: "return_prime",
+  label: "Return Prime",
+  events: EVENTS3,
+  defaultEvent: DEFAULT_EVENT3,
+  eventType: "return_prime_return_requested",
+  gate: { path: "request.request_type", value: "return" },
+  gateFor: (eventName) => ({ path: "request.status", value: eventDef2(eventName).status }),
+  signatureScheme: "none documented \u2014 every request is accepted",
+  signatureHeader: null,
+  fieldMap: fieldMap6,
+  fieldMapFor,
+  editableFields: editableFields6,
+  editableFieldsFor: editableFieldsFor3,
+  selectionFor: selectionFor3,
+  eventFromPayload: eventFromPayload3,
+  buildPayload: buildPayload6,
+  sign: sign6,
+  webhookUrl: webhookUrl6,
+  webhookSecret: webhookSecret6,
+  summarize: summarize6
+};
+
+// src/providers/fastrr.mjs
+var GATE_PATH4 = "event_name";
+var GATE_VALUE3 = "ABANDON_CART";
+var fieldMap7 = [
+  { source: "event_name", target: "\xABgate\xBB", required: true, note: "must be ABANDON_CART or the event is dropped" },
+  { source: "event_id", target: "eventId" },
+  { source: "event_data.phone_number", target: "phone", required: true, note: "BARE national number \u2014 region comes from the address" },
+  { source: "event_data.shipping_address.country_code", target: "phone region", required: true },
+  { source: "event_data.checkout_url", target: "checkoutUrl", required: true },
+  { source: "event_data.items[].name", target: "cart.productName", required: true, note: "the first PAID line wins; freebies rank last" },
+  { source: "event_data.items[].img_url", target: "cart.image" },
+  { source: "event_data.items[].price", target: "\u2014 (ranking only)", note: "a zero price marks the line a freebie" },
+  { source: "event_data.items[].sku", target: "cart.sku" },
+  { source: "event_data.item_count", target: "cart.itemCount" },
+  { source: "event_data.total_price", target: "pricing.totalPrice" },
+  { source: "event_data.total_discount", target: "pricing.totalDiscount" },
+  { source: "event_data.shipping_price", target: "pricing.shippingPrice" },
+  { source: "event_data.tax", target: "pricing.tax" },
+  { source: "event_data.currency", target: "pricing.currency" },
+  { source: "event_data.discount_codes[0]", target: "pricing.discountCode" },
+  { source: "event_data.custom_attributes.landing_page_url", target: "attribution.landingPage + utm.*", note: "utm is PARSED from this query string" },
+  { source: "event_data.latest_stage", target: "latestStage" },
+  { source: "event_data.payment_status", target: "paymentStatus" },
+  { source: "event_data.rtoPredict", target: "rtoPredict" },
+  { source: "event_data.cart_id", target: "cartId" },
+  { source: "event_data.cart_token", target: "cartToken" }
+];
+var editableFields7 = [
+  { group: "Event", path: "event_id", label: "Event id" },
+  { group: "Cart", path: "event_data.cart_id", label: "Cart id" },
+  { group: "Cart", path: "event_data.cart_token", label: "Cart token" },
+  { group: "Cart", path: "event_data.checkout_url", label: "Checkout URL", hint: "the link the shopper is sent back to" },
+  { group: "Cart", path: "event_data.latest_stage", label: "Latest stage" },
+  { group: "Cart", path: "event_data.payment_status", label: "Payment status" },
+  { group: "Cart", path: "event_data.rtoPredict", label: "RTO prediction", optional: true },
+  { group: "Pricing", path: "event_data.total_price", label: "Total price", type: "number" },
+  { group: "Pricing", path: "event_data.total_discount", label: "Discount", type: "number" },
+  { group: "Pricing", path: "event_data.shipping_price", label: "Shipping", type: "number" },
+  { group: "Pricing", path: "event_data.tax", label: "Tax", type: "number" },
+  { group: "Pricing", path: "event_data.currency", label: "Currency" },
+  { group: "Customer", path: "event_data.first_name", label: "First name" },
+  { group: "Customer", path: "event_data.last_name", label: "Last name" },
+  { group: "Customer", path: "event_data.email", label: "Email" },
+  { group: "Customer", path: "event_data.phone_number", label: "Phone", hint: "bare national number, no country code" },
+  { group: "Shipping", path: "event_data.shipping_address.address1", label: "Address line 1" },
+  { group: "Shipping", path: "event_data.shipping_address.city", label: "City" },
+  { group: "Shipping", path: "event_data.shipping_address.state", label: "State" },
+  { group: "Shipping", path: "event_data.shipping_address.zip", label: "Zip / postcode" },
+  { group: "Shipping", path: "event_data.shipping_address.country_code", label: "Country code", hint: "region used to parse the phone" },
+  { group: "Attribution", path: "event_data.custom_attributes.landing_page_url", label: "Landing page URL", hint: "utm parameters are read out of this query string" }
+];
+function buildPayload7(ctx) {
+  const { config, items, phone } = ctx;
+  const now = ctx.now ?? /* @__PURE__ */ new Date();
+  const currency = ctx.currency || config.defaults.currency;
+  const domain = config.shopify.domain;
+  const cust = config.customer;
+  const nationalPhone = nationalNumber(phone, cust.countryCode);
+  const lineItems = (items ?? []).map(({ product, variant, quantity }) => ({
+    sku: variant?.sku || "",
+    name: product.title,
+    title: product.title,
+    price: money2(variant?.price ?? 0),
+    quantity,
+    product_id: Number(product.id),
+    variant_id: Number(variant?.id ?? 0),
+    img_url: imageForVariant(product, variant),
+    custom_attributes: { contentId: String(product.id) }
+  }));
+  const subtotal = money2(lineItems.reduce((sum, li) => sum + li.price * li.quantity, 0));
+  const discount = money2(Math.min(ctx.discount ?? 0, subtotal));
+  const shippingPrice = ctx.shippingPrice ?? 0;
+  const total = money2(subtotal - discount + shippingPrice);
+  const landingPage = new URL(`https://${domain}/products/${items?.[0]?.product?.handle ?? ""}`);
+  for (const [key, value] of Object.entries(config.defaults.utm ?? {})) {
+    if (value) landingPage.searchParams.set(key, String(value));
+  }
+  const address = {
+    zip: cust.zip,
+    city: cust.city,
+    state: cust.province,
+    name: `${cust.firstName} ${cust.lastName}`.trim(),
+    phone: nationalPhone,
+    country: cust.country,
+    address1: cust.address1,
+    last_name: cust.lastName,
+    first_name: cust.firstName,
+    country_code: cust.countryCode,
+    line_1: cust.address1,
+    email: cust.email
+  };
+  const cartToken = `fastrr-${now.getTime()}`;
+  return {
+    event_id: `fr-${now.getTime()}`,
+    event_name: GATE_VALUE3,
+    event_data: {
+      checkout_url: cartPermalink(domain, (items ?? []).map(({ variant, quantity }) => ({ variantId: variant?.id, quantity }))),
+      total_discount: discount,
+      latest_stage: "ORDER_SCREEN",
+      product_id_list: lineItems.map((li) => String(li.product_id)),
+      billing_address: address,
+      custom_attributes: {
+        landing_page_url: landingPage.toString(),
+        ipv4_address: "192.168.1.1",
+        shopifyCartToken: cartToken
+      },
+      cart_id: cartToken,
+      updated_at: now.toISOString().replace("Z", ""),
+      currency,
+      shipping_address: address,
+      first_name: cust.firstName,
+      email: cust.email,
+      source_name: "fastrr",
+      item_count: lineItems.length,
+      shipping_price: shippingPrice,
+      variant_id_list: lineItems.map((li) => String(li.variant_id)),
+      total_price: total,
+      payment_status: "Pending",
+      last_name: cust.lastName,
+      tax: 0,
+      item_title_list: lineItems.map((li) => li.title),
+      item_name_list: lineItems.map((li) => li.name),
+      img_url: lineItems[0]?.img_url,
+      sku_list: lineItems.map((li) => li.sku),
+      item_price_list: lineItems.map((li) => String(li.price)),
+      cart_token: cartToken,
+      phone_number: nationalPhone,
+      items: lineItems,
+      discount_codes: ctx.couponCode ? [ctx.couponCode] : [],
+      rtoPredict: "low"
+    }
+  };
+}
+function sign7() {
+  return { signature: null, timestamp: null, headers: { "content-type": "application/json" } };
+}
+function webhookUrl7(config) {
+  return String(targetFor(config, "fastrr").webhookUrl ?? "").trim();
+}
+function webhookSecret7(config) {
+  return String(targetFor(config, "fastrr").webhookSecret ?? "");
+}
+function summarize7(payload) {
+  const d = payload?.event_data ?? {};
+  let store;
+  try {
+    store = d.checkout_url ? new URL(d.checkout_url).host : void 0;
+  } catch {
+    store = d.checkout_url;
+  }
+  const items = Array.isArray(d.items) ? d.items : [];
+  return {
+    event: "abandoned cart",
+    store,
+    customer: `${d.first_name ?? ""} ${d.last_name ?? ""} \xB7 ${d.phone_number ?? ""}`.trim(),
+    items: items.map((i) => `${i.name} x${i.quantity}`).join(", "),
+    total: d.total_price,
+    currency: d.currency,
+    extra: `stage ${d.latest_stage}, rto ${d.rtoPredict}`,
+    link: d.checkout_url
+  };
+}
+var fastrr_default = {
+  id: "fastrr",
+  urlKey: "fastrr",
+  label: "Fastrr",
+  eventType: "fastrr_abandoned_cart",
+  gate: { path: GATE_PATH4, value: GATE_VALUE3 },
+  signatureScheme: "none documented \u2014 every request is accepted",
+  signatureHeader: null,
+  fieldMap: fieldMap7,
+  editableFields: editableFields7,
+  buildPayload: buildPayload7,
+  sign: sign7,
+  webhookUrl: webhookUrl7,
+  webhookSecret: webhookSecret7,
+  summarize: summarize7
+};
+
 // src/providers/index.mjs
 var PROVIDER_META = [
   {
@@ -1095,12 +2077,46 @@ var PROVIDER_META = [
     header: "authorization",
     available: true,
     events: nitro_default.events
+  },
+  {
+    id: "shopflo",
+    label: "Shopflo",
+    signature: "none documented \u2014 every request is accepted",
+    header: null,
+    available: true,
+    events: shopflo_default.events
+  },
+  {
+    id: "flexype",
+    label: "FlexyPe",
+    signature: "static shared secret in the header",
+    header: "x-flexype-authorization",
+    available: true
+  },
+  {
+    id: "return-prime",
+    label: "Return Prime",
+    signature: "none documented \u2014 every request is accepted",
+    header: null,
+    available: true,
+    events: return_prime_default.events
+  },
+  {
+    id: "fastrr",
+    label: "Fastrr",
+    signature: "none documented \u2014 every request is accepted",
+    header: null,
+    available: true
   }
 ];
 var providers = {
   [cashfree_occ_default.id]: cashfree_occ_default,
   [razorpay_magic_default.id]: razorpay_magic_default,
-  [nitro_default.id]: nitro_default
+  [nitro_default.id]: nitro_default,
+  [shopflo_default.id]: shopflo_default,
+  [flexype_default.id]: flexype_default,
+  [return_prime_default.id]: return_prime_default,
+  [fastrr_default.id]: fastrr_default
 };
 function getProvider(id) {
   const provider = providers[id];
@@ -1466,74 +2482,6 @@ function autoSelect(products, count = 1) {
   }));
 }
 
-// src/phone.mjs
-var CALLING_CODES = {
-  IN: "91",
-  US: "1",
-  CA: "1",
-  GB: "44",
-  AE: "971",
-  SG: "65",
-  AU: "61",
-  NZ: "64",
-  DE: "49",
-  FR: "33",
-  IT: "39",
-  ES: "34",
-  NL: "31",
-  SE: "46",
-  RO: "40",
-  PL: "48",
-  ZA: "27",
-  NG: "234",
-  KE: "254",
-  BD: "880",
-  PK: "92",
-  LK: "94",
-  NP: "977",
-  MY: "60",
-  ID: "62",
-  PH: "63",
-  TH: "66",
-  VN: "84",
-  JP: "81",
-  KR: "82",
-  CN: "86",
-  SA: "966",
-  QA: "974",
-  KW: "965",
-  OM: "968",
-  BH: "973",
-  BR: "55",
-  MX: "52"
-};
-function callingCode(regionCode) {
-  return CALLING_CODES[String(regionCode || "").toUpperCase()] || null;
-}
-function toE164(raw, regionCode) {
-  const cleaned = String(raw ?? "").replace(/\s+/g, "");
-  if (!cleaned) return { ok: false, reason: "phone is empty" };
-  if (cleaned.startsWith("+")) {
-    const digits2 = cleaned.slice(1).replace(/\D/g, "");
-    if (digits2.length < 8 || digits2.length > 15) return { ok: false, reason: `+${digits2} is not a plausible E.164 length` };
-    return { ok: true, value: `+${digits2}` };
-  }
-  const cc = callingCode(regionCode);
-  if (!cc) {
-    return {
-      ok: false,
-      reason: `no country calling code known for region "${regionCode}" \u2014 give the phone in +E.164 form instead`
-    };
-  }
-  let national = cleaned.replace(/\D/g, "").replace(/^0+/, "");
-  if (national.startsWith(cc) && national.length > 10) national = national.slice(cc.length);
-  const value = `+${cc}${national}`;
-  const digits = value.slice(1);
-  if (digits.length < 8 || digits.length > 15) return { ok: false, reason: `${value} is not a plausible E.164 length` };
-  return { ok: true, value };
-}
-var knownRegions = Object.keys(CALLING_CODES);
-
 // src/core/paths.mjs
 function getPath(obj, path6) {
   return String(path6).replace(/\[(\d+)\]/g, ".$1").split(".").reduce((acc, key) => acc == null ? void 0 : acc[key], obj);
@@ -1701,7 +2649,19 @@ function locatePhone(payload) {
     ["phone", "customer.Shipping_address.Country_code"],
     ["customer.Shipping_address.Phone", "customer.Shipping_address.Country_code"],
     // nitro
-    ["eventVal.customer.phone", "country"]
+    ["eventVal.customer.phone", "country"],
+    // shopflo — one path per envelope, most specific first
+    ["eventPayload.userData.phone", "eventPayload.clientData.country"],
+    ["data.user_data.phone", "data.country_code"],
+    ["customer.phone", "customer.country_code"],
+    // flexype
+    ["payload.user.phone_with_dial_code", "payload.checkout_context.presentment_country"],
+    ["payload.user.phone", "payload.checkout_context.presentment_country"],
+    // return prime — wrapped and root envelopes
+    ["request.customer.phone", "request.customer.address.country_code"],
+    // fastrr — a bare national number, so the region is what makes it parse
+    ["event_data.phone_number", "event_data.shipping_address.country_code"],
+    ["event_data.billing_address.phone", "event_data.billing_address.country_code"]
   ];
   for (const [phonePath, regionPath] of candidates) {
     const phone = getPath(payload, phonePath);
@@ -1736,8 +2696,8 @@ 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 coverage(payload, fieldMap4) {
-  return fieldMap4.map((f) => {
+function coverage(payload, fieldMap8) {
+  return fieldMap8.map((f) => {
     const value = getPath(payload, f.source);
     const present = value !== void 0 && value !== null && value !== "";
     return {
@@ -1864,7 +2824,7 @@ function loadPayload(file) {
 }
 
 // src/core/build.mjs
-function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, phone, eventName, collection }) {
+function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, phone, eventName, collection, envelope }) {
   const provider = getProvider(providerId);
   const event = eventName ?? provider.defaultEvent;
   const resolvedPhone = phone ?? cfg.customer.phone;
@@ -1875,6 +2835,7 @@ function draftPayload({ cfg, providerId = "cashfree-occ", items, discount = 0, p
     discount,
     eventName: event,
     collection,
+    envelope,
     phone: parsed.ok ? parsed.value : String(resolvedPhone ?? "")
   });
   const editable = provider.editableFieldsFor ? provider.editableFieldsFor(event) : provider.editableFields;
@@ -1890,7 +2851,7 @@ function applyEdits(payload, fields, edits) {
   }
   return payload;
 }
-async function buildPayload4({ cfg, providerId = "cashfree-occ", items = [], discount = 0, phone, checkImageUrls = true, payload: prebuilt, eventName, collection }) {
+async function buildPayload8({ cfg, providerId = "cashfree-occ", items = [], discount = 0, phone, checkImageUrls = true, payload: prebuilt, eventName, collection, envelope }) {
   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");
@@ -1899,7 +2860,7 @@ async function buildPayload4({ 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 });
+  const payload = prebuilt ?? provider.buildPayload({ config: cfg, items, discount, phone: parsed.value, eventName: event, collection, envelope });
   const body = JSON.stringify(payload);
   const report = await runAll({ payload, body, provider, config: cfg, checkImageUrls, eventName: event });
   const summary = provider.summarize ? provider.summarize(payload) : {};
@@ -2169,7 +3130,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         return setStep(STEP.MODE);
       case STEP.RESULT:
       case STEP.ERROR:
-        return onDone();
+        return built ? setStep(STEP.REPORT) : onDone();
       default:
         return onDone();
     }
@@ -2323,7 +3284,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
   const onDiscount = (raw) => startReview(Math.max(0, Number.parseFloat(raw) || 0));
   const finalise = (payload) => {
     setStep(STEP.BUILDING);
-    buildPayload4({ cfg: config, providerId, items, discount: draft.discount, payload, eventName, collection }).then(async (result) => {
+    buildPayload8({ cfg: config, providerId, items, discount: draft.discount, payload, eventName, collection }).then(async (result) => {
       setBuilt(result);
       let req = null;
       let command = "";
@@ -2596,7 +3557,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: "reproduce:" }),
         /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: sendResult.curl })
       ] }),
-      /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: "press enter to return to the menu" }) })
+      /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: "enter returns to the menu \xB7 esc goes back to the report to retry" }) })
     ] }),
     step === STEP.ERROR && error && /* @__PURE__ */ jsxs8(Box8, { flexDirection: "column", children: [
       /* @__PURE__ */ jsx8(Alert, { variant: "error", children: error.message }),
@@ -2606,7 +3567,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
         /* @__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" }) })
+      /* @__PURE__ */ jsx8(Box8, { marginTop: 1, children: /* @__PURE__ */ jsx8(Text8, { color: palette.dim, children: "enter returns to the menu \xB7 esc goes back to the report to retry" }) })
     ] })
   ] });
 }
@@ -3567,11 +4528,12 @@ async function cmdBuild(args, config) {
   } else {
     log.ok(`${eventName} needs no product or collection`);
   }
-  const built = await buildPayload4({
+  const built = await buildPayload8({
     cfg: config,
     providerId,
     eventName,
     collection,
+    envelope: typeof args.flags.envelope === "string" ? args.flags.envelope : void 0,
     items,
     discount,
     phone: typeof args.flags.phone === "string" ? args.flags.phone : void 0,
@@ -3774,10 +4736,18 @@ ${c.bold("COMMANDS")}
   help         show this message
 
 ${c.bold("BUILD OPTIONS")}
-  --provider <id>    cashfree-occ | razorpay-magic | nitro       (default cashfree-occ)
-  --event <name>     nitro only: view \xB7 category_view \xB7 product_view \xB7 addtocart
-                     removefromcart \xB7 checkout \xB7 orders/create \xB7 orders/updated
-  --collection <x>   nitro category_view: collection id, handle or title
+  --provider <id>    cashfree-occ \xB7 razorpay-magic \xB7 nitro \xB7 shopflo
+                     flexype \xB7 return-prime \xB7 fastrr           (default cashfree-occ)
+  --event <name>     multi-event providers only:
+                     nitro        view \xB7 category_view \xB7 product_view \xB7 addtocart
+                                  removefromcart \xB7 checkout \xB7 orders/create \xB7 orders/updated
+                     shopflo      store_page_view \xB7 collection_page_viewed \xB7 product_page_viewed
+                                  added_to_cart_ui \xB7 checkout_clicked \xB7 checkout_abandoned
+                                  order_completed
+                     return-prime {return,exchange}_{requested,approved,received,
+                                  inspected,rejected}
+  --envelope <x>     return-prime only: wrapped (default) or root
+  --collection <x>   category or collection view: collection id, handle or title
   --items <n>        how many products to put in the cart      (default 1)
   --search <text>    only consider products matching a title
   --discount <n>     cart discount in major currency units     (default 0)