hookwright 1.2.1 → 1.2.3

package/README.md

@@ -75,6 +75,8 @@ Every command works without a TTY, for CI or scripting:
 hookwright build --items 2                              # cashfree-occ by default
 hookwright build --provider razorpay-magic --items 2
 hookwright build --provider nitro --event orders/create
+hookwright build --provider nitro --event category_view --collection summer-sale
+hookwright build --provider nitro --event view          # no product needed
 hookwright build --search "cold brew"      # only products matching a title
 hookwright build --items 3 --discount 250 --send
 hookwright send --dry-run                  # print the request + curl, send nothing
@@ -142,7 +144,7 @@ Adding one is a single file in `src/providers/` exporting `buildPayload`, `sign`
 ```bash
 npm install
 npm run dev     # esbuild watch
-npm test        # 187 tests, no network required
+npm test        # 190 tests, no network required
 npm start       # build + run
 ```
 

package/dist/cli.js

@@ -24,7 +24,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "hookwright",
-      version: "1.2.1",
+      version: "1.2.3",
       description: "Build real, signed e-commerce webhooks from a live Shopify catalogue \u2014 interactive terminal UI, no backend",
       keywords: [
         "webhook",
@@ -776,6 +776,9 @@ var EVENTS = [
   { eventName: "orders/create", type: "nitro_orders_create", label: "Order Created", selection: "cart", subject: "ordered items" },
   { eventName: "orders/updated", type: "nitro_orders_updated", label: "Order Updated", selection: "cart", subject: "ordered items" }
 ];
+function eventFromPayload(payload) {
+  return payload?.eventName;
+}
 function selectionFor(eventName) {
   return EVENTS.find((e) => e.eventName === eventName)?.selection ?? "cart";
 }
@@ -1061,6 +1064,7 @@ var nitro_default = {
   editableFields: editableFields3,
   editableFieldsFor,
   selectionFor,
+  eventFromPayload,
   buildPayload: buildPayload3,
   sign: sign3,
   webhookUrl: webhookUrl3,
@@ -1773,10 +1777,11 @@ async function checkImages(payload, { timeoutMs = 1e4 } = {}) {
   }));
 }
 async function runAll({ payload, body, provider, config, checkImageUrls = true, checkEndpoint = true, eventName }) {
-  const checks = [checkGate(payload, provider, eventName), checkRoundTrip(body), checkPhone(payload), checkAllowedPhone(payload, config)];
+  const event = eventName ?? (provider.eventFromPayload ? provider.eventFromPayload(payload) : void 0);
+  const checks = [checkGate(payload, provider, event), checkRoundTrip(body), checkPhone(payload), checkAllowedPhone(payload, config)];
   if (checkImageUrls) checks.push(...await checkImages(payload));
   if (checkEndpoint) checks.push(await checkEndpointExists(provider.webhookUrl(config)));
-  const fields = eventName && provider.fieldMapFor ? provider.fieldMapFor(eventName) : provider.fieldMap;
+  const fields = event && provider.fieldMapFor ? provider.fieldMapFor(event) : provider.fieldMap;
   const cov = coverage(payload, fields);
   const missing = cov.filter((c2) => c2.status === "MISSING");
   checks.push({
@@ -1918,7 +1923,8 @@ async function buildPayload4({ cfg, providerId = "cashfree-occ", items = [], dis
   };
   const file = savePayload({ provider: provider.id, payload, body, meta });
   audit("payload.built", { provider: provider.id, valid: report.ok, file });
-  return { provider, payload, body, report, file, meta, summary };
+  const record = { provider: provider.id, payload, body, meta };
+  return { provider, payload, body, report, file, meta, summary, record };
 }
 
 // src/core/send.mjs
@@ -2356,7 +2362,7 @@ function Build({ config, providerId = "cashfree-occ", onDone }) {
   };
   const doSend = () => {
     setStep(STEP.SENDING);
-    dispatch({ cfg: config, record: { provider: built.provider.id, payload: built.payload, body: built.body } }).then((result) => {
+    dispatch({ cfg: config, record: built.record }).then((result) => {
       setSendResult(result);
       setStep(STEP.RESULT);
     }).catch((err) => {
@@ -3530,18 +3536,42 @@ async function cmdBuild(args, config) {
   const discount = Number.parseFloat(args.flags.discount ?? "0") || 0;
   const search = typeof args.flags.search === "string" ? args.flags.search : void 0;
   const checkImageUrls = args.flags.image !== false && args.flags["image-check"] !== false;
-  log.step(`fetching products from ${config.shopify.domain}\u2026`);
-  const products = await fetchCatalogue(config, { search });
-  if (!products.length) {
-    log.fail("Shopify returned no products");
-    return 1;
+  const provider = getProvider(providerId);
+  const eventName = typeof args.flags.event === "string" ? args.flags.event : provider.defaultEvent;
+  const selection = provider.selectionFor ? provider.selectionFor(eventName) : "cart";
+  let items = [];
+  let collection;
+  if (selection === "collection") {
+    log.step(`fetching collections from ${config.shopify.domain}\u2026`);
+    const collections = await fetchCollections(config, { search });
+    if (!collections.length) {
+      log.fail("Shopify returned no collections");
+      log.dim("create one in Shopify, or pick a different event");
+      return 1;
+    }
+    const wanted = typeof args.flags.collection === "string" ? args.flags.collection.toLowerCase() : null;
+    collection = collections.find((c2) => wanted && (c2.id === wanted || c2.handle === wanted || c2.title.toLowerCase() === wanted)) ?? collections[0];
+    if (wanted && collection.title.toLowerCase() !== wanted && collection.id !== wanted && collection.handle !== wanted) {
+      log.warn(`no collection matched "${args.flags.collection}", using ${collection.title}`);
+    }
+    log.ok(`collection: ${collection.title}`);
+  } else if (selection !== "none") {
+    log.step(`fetching products from ${config.shopify.domain}\u2026`);
+    const products = await fetchCatalogue(config, { search });
+    if (!products.length) {
+      log.fail("Shopify returned no products");
+      return 1;
+    }
+    items = autoSelect(products, selection === "product" ? 1 : count);
+    log.ok(`${items.length} product(s): ${items.map((i) => i.product.title).join(", ")}`);
+  } else {
+    log.ok(`${eventName} needs no product or collection`);
   }
-  const items = autoSelect(products, count);
-  log.ok(`${items.length} product(s): ${items.map((i) => i.product.title).join(", ")}`);
   const built = await buildPayload4({
     cfg: config,
     providerId,
-    eventName: typeof args.flags.event === "string" ? args.flags.event : void 0,
+    eventName,
+    collection,
     items,
     discount,
     phone: typeof args.flags.phone === "string" ? args.flags.phone : void 0,
@@ -3586,7 +3616,7 @@ async function cmdBuild(args, config) {
 async function cmdSend(args, config, built) {
   const bad = requireConfig(config);
   if (bad) return bad;
-  let record = built ? { provider: built.provider.id, payload: built.payload, body: built.body } : null;
+  let record = built?.record ?? null;
   if (!record && typeof args.flags.file === "string") record = loadPayload(args.flags.file);
   if (!record) record = loadLast();
   if (!record) {
@@ -3747,6 +3777,7 @@ ${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
   --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)

package/package.json

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