punchout-simulator 0.6.0 → 0.7.0

package/README.md

@@ -18,10 +18,12 @@ It is role-neutral and runs in two modes (mirror images of each other):
 
 Protocol scope: **cXML only**.
 
-> **New to PunchOut, or want the full picture?** See the in-depth reports in
-> [`docs/`](docs/): the [PunchOut business primer](docs/punchout-business-primer_en.html),
-> the [Architecture reference](docs/architecture_en.html), and the
-> [Operations & usage guide](docs/operations-guide_en.html).
+> **New to PunchOut, or want the full picture?** Read the in-depth reports at
+> [**slawomir-szostak.github.io/punchout-simulator**](https://slawomir-szostak.github.io/punchout-simulator/):
+> the [PunchOut business primer](https://slawomir-szostak.github.io/punchout-simulator/punchout-business-primer_en.html),
+> the [Architecture reference](https://slawomir-szostak.github.io/punchout-simulator/architecture_en.html),
+> and the [Operations & usage guide](https://slawomir-szostak.github.io/punchout-simulator/operations-guide_en.html).
+> (Markdown sources live in [`docs/`](docs/).)
 
 ---
 
@@ -206,12 +208,13 @@ src/
 
 For a deeper treatment — component breakdown, the full data model, and Mode A /
 Mode B sequence diagrams — see the
-[**Architecture reference**](docs/architecture_en.html) in [`docs/`](docs/).
-The same folder holds a [**PunchOut business primer**](docs/punchout-business-primer_en.html)
+[**Architecture reference**](https://slawomir-szostak.github.io/punchout-simulator/architecture_en.html).
+Alongside it: a [**PunchOut business primer**](https://slawomir-szostak.github.io/punchout-simulator/punchout-business-primer_en.html)
 (the business process and where this tool fits) and an
-[**Operations & usage guide**](docs/operations-guide_en.html) (sessions,
-operations, profiles, product lists, validation). The reports are self-contained
-HTML; their canonical Markdown sources sit alongside them.
+[**Operations & usage guide**](https://slawomir-szostak.github.io/punchout-simulator/operations-guide_en.html)
+(sessions, operations, profiles, product lists, validation). These render at
+[slawomir-szostak.github.io/punchout-simulator](https://slawomir-szostak.github.io/punchout-simulator/);
+their canonical Markdown sources live in [`docs/`](docs/).
 
 ### Data model
 

package/dist/server/cli.js

@@ -1620,31 +1620,39 @@ function collectCidReferences(doc) {
   });
   return refs;
 }
+function itemFromNode(it) {
+  const detail = it?.ItemDetail;
+  const up = money(detail?.UnitPrice);
+  const classifications = asArray(detail?.Classification).filter((c) => c != null).map((c) => ({ domain: attr(c, "domain") ?? "", value: text(c) ?? "" }));
+  const classFirst = classifications[0];
+  return {
+    quantity: Number(attr(it, "quantity") ?? "1") || 1,
+    supplierPartId: text(it?.ItemID?.SupplierPartID),
+    supplierPartAuxiliaryId: text(it?.ItemID?.SupplierPartAuxiliaryID),
+    description: text(detail?.Description),
+    uom: text(detail?.UnitOfMeasure),
+    unitPriceAmount: up.amount,
+    currency: up.currency,
+    classifications: classifications.length > 0 ? classifications : void 0,
+    classificationDomain: classFirst?.domain,
+    classification: classFirst?.value,
+    manufacturerPartId: text(detail?.ManufacturerPartID),
+    manufacturerName: text(detail?.ManufacturerName)
+  };
+}
+function parseSetupItems(doc) {
+  const sr = root(doc)?.Request?.PunchOutSetupRequest;
+  return {
+    operation: attr(sr, "operation") ?? "create",
+    items: asArray(sr?.ItemOut).map(itemFromNode)
+  };
+}
 function parseCart(doc) {
   const pom = root(doc)?.Message?.PunchOutOrderMessage;
   const sessionId = text(pom?.BuyerCookie) ?? "";
   const headerNode = pom?.PunchOutOrderMessageHeader;
   const total = money(headerNode?.Total);
-  const items = asArray(pom?.ItemIn).map((it) => {
-    const detail = it?.ItemDetail;
-    const up = money(detail?.UnitPrice);
-    const classifications = asArray(detail?.Classification).filter((c) => c != null).map((c) => ({ domain: attr(c, "domain") ?? "", value: text(c) ?? "" }));
-    const classFirst = classifications[0];
-    return {
-      quantity: Number(attr(it, "quantity") ?? "1") || 1,
-      supplierPartId: text(it?.ItemID?.SupplierPartID),
-      supplierPartAuxiliaryId: text(it?.ItemID?.SupplierPartAuxiliaryID),
-      description: text(detail?.Description),
-      uom: text(detail?.UnitOfMeasure),
-      unitPriceAmount: up.amount,
-      currency: up.currency,
-      classifications: classifications.length > 0 ? classifications : void 0,
-      classificationDomain: classFirst?.domain,
-      classification: classFirst?.value,
-      manufacturerPartId: text(detail?.ManufacturerPartID),
-      manufacturerName: text(detail?.ManufacturerName)
-    };
-  });
+  const items = asArray(pom?.ItemIn).map(itemFromNode);
   return {
     sessionId,
     operationAllowed: attr(headerNode, "operationAllowed"),
@@ -2522,6 +2530,20 @@ var catalogOf = (s) => {
   const items = catalogForSupplier(s);
   return items.length > 0 ? items : DEMO_CATALOG;
 };
+function setupContextFor(cookie) {
+  if (!cookie) return { operation: "create", items: [] };
+  const records = readSession(cookie);
+  for (let i = records.length - 1; i >= 0; i--) {
+    const r = records[i];
+    if (r.direction === "in" && r.docType === "SetupRequest") {
+      return parseSetupItems(parseXml(r.body));
+    }
+  }
+  return { operation: "create", items: [] };
+}
+function sameProduct(a, b) {
+  return !!a.supplierPartId && a.supplierPartId === b.supplierPartId && (a.supplierPartAuxiliaryId ?? "") === (b.supplierPartAuxiliaryId ?? "");
+}
 function safeHttpUrl(u) {
   if (!u) return "";
   try {
@@ -2590,26 +2612,46 @@ simRoute.post("/:id/punchout", async (c) => {
   c.header("Content-Type", "text/xml; charset=UTF-8");
   return c.body(respXml);
 });
-simRoute.get("/:id/catalog", (c) => {
-  const supplier = getSupplier(c.req.param("id"));
-  if (!supplier) return c.text("supplier not found", 404);
-  const cookie = c.req.query("cookie") ?? "";
-  const formpost = safeHttpUrl(c.req.query("formpost") ?? "");
-  const bd = c.req.query("bd") ?? "";
-  const bi = c.req.query("bi") ?? "";
-  const items = catalogOf(supplier);
-  const rows = items.map((it, i) => {
-    const partId = escapeXml(it.supplierPartId) + (it.supplierPartAuxiliaryId ? ` / ${escapeXml(it.supplierPartAuxiliaryId)}` : "");
-    const cls = (it.classifications ?? []).map((c2) => `${escapeXml(c2.domain)} ${escapeXml(c2.value)}`).join(" \xB7 ");
-    return `<tr>
-      <td><strong>${escapeXml(it.description)}</strong><br><small>${partId} \xB7 ${escapeXml(it.uom)}${cls ? ` \xB7 ${cls}` : ""}</small></td>
-      <td class="price">${escapeXml(it.currency)} ${it.unitPrice.toFixed(2)}</td>
-      <td><input type="number" name="q_${i}" value="0" min="0" step="${it.allowFractional ? "any" : "1"}" inputmode="${it.allowFractional ? "decimal" : "numeric"}"></td>
+var catalogView = (it) => ({
+  description: it.description,
+  supplierPartId: it.supplierPartId,
+  supplierPartAuxiliaryId: it.supplierPartAuxiliaryId,
+  uom: it.uom,
+  currency: it.currency,
+  price: it.unitPrice,
+  classifications: it.classifications
+});
+var cartView = (it) => ({
+  description: it.description,
+  supplierPartId: it.supplierPartId,
+  supplierPartAuxiliaryId: it.supplierPartAuxiliaryId,
+  uom: it.uom,
+  currency: it.currency,
+  price: it.unitPriceAmount,
+  classifications: it.classifications
+});
+function rowLabelCells(v) {
+  const partId = escapeXml(v.supplierPartId ?? "") + (v.supplierPartAuxiliaryId ? ` / ${escapeXml(v.supplierPartAuxiliaryId)}` : "");
+  const cls = (v.classifications ?? []).map((c) => `${escapeXml(c.domain)} ${escapeXml(c.value)}`).join(" \xB7 ");
+  return `<td><strong>${escapeXml(v.description ?? "")}</strong><br><small>${partId} \xB7 ${escapeXml(v.uom ?? "")}${cls ? ` \xB7 ${cls}` : ""}</small></td>
+      <td class="price">${escapeXml(v.currency ?? "")} ${(v.price ?? 0).toFixed(2)}</td>`;
+}
+function qtyRow(v, name, value, fractional, tag) {
+  return `<tr>
+      ${rowLabelCells(v)}
+      <td><input type="number" name="${name}" value="${escapeXml(value)}" min="0" step="${fractional ? "any" : "1"}" inputmode="${fractional ? "decimal" : "numeric"}">${tag ? ` <span class="tag">${tag}</span>` : ""}</td>
     </tr>`;
-  }).join("\n");
-  return c.html(`<!doctype html><html lang="en"><head><meta charset="utf-8">
+}
+function readonlyRow(v, qty) {
+  return `<tr>
+      ${rowLabelCells(v)}
+      <td class="ro">${escapeXml(qty)}</td>
+    </tr>`;
+}
+function catalogPage(o) {
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1">
-<title>${escapeXml(supplier.name)} \u2014 mock catalog</title>
+<title>${escapeXml(o.supplier.name)} \u2014 mock catalog</title>
 <script>
   // Match the main app's theme. The app appends ?theme= to the catalog link
   // (works even when the SPA is on a different origin, e.g. the Vite dev server);
@@ -2627,31 +2669,61 @@ simRoute.get("/:id/catalog", (c) => {
   })();
 </script>
 <style>
-  :root{--bg:#0f172a;--text:#e2e8f0;--muted:#94a3b8;--panel:#1e293b;--th:#0b1220;--border:#334155;--field:#0b1220;--price:#fbbf24;--accent:#6366f1;--accent-hover:#4f46e5}
-  :root[data-theme="light"]{--bg:#f5f7fb;--text:#1e293b;--muted:#4b5a73;--panel:#ffffff;--th:#eef1f7;--border:#d4dae8;--field:#ffffff;--price:#b45309;--accent:#6366f1;--accent-hover:#4f46e5}
+  :root{--bg:#0f172a;--text:#e2e8f0;--muted:#94a3b8;--panel:#1e293b;--th:#0b1220;--border:#334155;--field:#0b1220;--price:#fbbf24;--accent:#6366f1;--accent-hover:#4f46e5;--banner:#1e293b}
+  :root[data-theme="light"]{--bg:#f5f7fb;--text:#1e293b;--muted:#4b5a73;--panel:#ffffff;--th:#eef1f7;--border:#d4dae8;--field:#ffffff;--price:#b45309;--accent:#6366f1;--accent-hover:#4f46e5;--banner:#eef1f7}
   body{font-family:system-ui,sans-serif;background:var(--bg);color:var(--text);margin:0;padding:2rem}
   .wrap{max-width:720px;margin:0 auto}
   h1{font-size:1.4rem}.sub{color:var(--muted);margin-bottom:1.5rem}
+  .banner{background:var(--banner);border:1px solid var(--border);border-left:4px solid var(--accent);border-radius:8px;padding:.7rem 1rem;margin-bottom:1.25rem;font-size:.95rem}
+  .banner.inspect{border-left-color:var(--price)}
   table{width:100%;border-collapse:collapse;background:var(--panel);border-radius:12px;overflow:hidden}
   th,td{padding:.75rem 1rem;text-align:left;border-bottom:1px solid var(--border)}
   th{background:var(--th);font-size:.8rem;text-transform:uppercase;letter-spacing:.05em;color:var(--muted)}
   .price{white-space:nowrap;color:var(--price)}
+  .ro{color:var(--muted)}
+  .tag{font-size:.7rem;color:var(--muted);text-transform:uppercase;letter-spacing:.04em;margin-left:.4rem}
   input[type=number]{width:5rem;background:var(--field);border:1px solid var(--border);color:var(--text);border-radius:6px;padding:.35rem .5rem}
   button{margin-top:1.5rem;background:var(--accent);color:#fff;border:0;border-radius:8px;padding:.7rem 1.4rem;font-size:1rem;cursor:pointer}
   button:hover{background:var(--accent-hover)}
 </style></head><body><div class="wrap">
-  <h1>${escapeXml(supplier.name)} <small>(virtual supplier)</small></h1>
+  <h1>${escapeXml(o.supplier.name)} <small>(virtual supplier)</small></h1>
   <div class="sub">Mock catalog served by punchout-simulator. Set quantities and return the cart.</div>
-  <form method="post" action="${getPublicUrl()}/sim/${supplier.id}/checkout">
-    <input type="hidden" name="cookie" value="${escapeXml(cookie)}">
-    <input type="hidden" name="formpost" value="${escapeXml(formpost)}">
-    <input type="hidden" name="bd" value="${escapeXml(bd)}">
-    <input type="hidden" name="bi" value="${escapeXml(bi)}">
+  ${o.banner}
+  <form method="post" action="${getPublicUrl()}/sim/${o.supplier.id}/checkout">
+    <input type="hidden" name="cookie" value="${escapeXml(o.cookie)}">
+    <input type="hidden" name="formpost" value="${escapeXml(o.formpost)}">
+    <input type="hidden" name="bd" value="${escapeXml(o.bd)}">
+    <input type="hidden" name="bi" value="${escapeXml(o.bi)}">
     <table><thead><tr><th>Item</th><th>Price</th><th>Qty</th></tr></thead>
-    <tbody>${rows}</tbody></table>
-    <button type="submit">Return cart to buyer \u2192</button>
+    <tbody>${o.rows}</tbody></table>
+    <button type="submit">${escapeXml(o.submitLabel)}</button>
   </form>
-</div></body></html>`);
+</div></body></html>`;
+}
+simRoute.get("/:id/catalog", (c) => {
+  const supplier = getSupplier(c.req.param("id"));
+  if (!supplier) return c.text("supplier not found", 404);
+  const cookie = c.req.query("cookie") ?? "";
+  const formpost = safeHttpUrl(c.req.query("formpost") ?? "");
+  const bd = c.req.query("bd") ?? "";
+  const bi = c.req.query("bi") ?? "";
+  const items = catalogOf(supplier);
+  const ctx = setupContextFor(cookie);
+  const page = (banner2, rows2, submitLabel) => c.html(catalogPage({ supplier, banner: banner2, rows: rows2, submitLabel, cookie, formpost, bd, bi }));
+  if (ctx.operation === "inspect" && ctx.items.length > 0) {
+    const rows2 = ctx.items.map((it) => readonlyRow(cartView(it), it.quantity)).join("\n");
+    const banner2 = `<div class="banner inspect">Inspect \u2014 ${ctx.items.length} item(s), read-only. Returning the cart unchanged to the buyer.</div>`;
+    return page(banner2, rows2, "Return to buyer \u2192");
+  }
+  const isEdit = ctx.operation === "edit";
+  const prefill = (it) => isEdit ? ctx.items.find((p) => sameProduct(p, it))?.quantity ?? 0 : 0;
+  const catalogRows = items.map((it, i) => qtyRow(catalogView(it), `q_${i}`, prefill(it), !!it.allowFractional)).join("\n");
+  const extras = isEdit ? ctx.items.filter((p) => !items.some((it) => sameProduct(p, it))) : [];
+  const extraRows = extras.map((p, j) => qtyRow(cartView(p), `qx_${j}`, p.quantity, true, "from cart")).join("\n");
+  const banner = isEdit ? `<div class="banner edit">Edit \u2014 ${ctx.items.length} item(s) pre-loaded from the buyer's cart. Adjust quantities and return.</div>` : "";
+  const rows = extraRows ? `${catalogRows}
+${extraRows}` : catalogRows;
+  return page(banner, rows, "Return cart to buyer \u2192");
 });
 simRoute.post("/:id/checkout", async (c) => {
   const supplier = getSupplier(c.req.param("id"));
@@ -2664,29 +2736,41 @@ simRoute.post("/:id/checkout", async (c) => {
   const formpost = safeHttpUrl(String(form.formpost ?? ""));
   const buyerCred = { domain: String(form.bd ?? ""), identity: String(form.bi ?? "") };
   const catalog = catalogOf(supplier);
-  const items = [];
-  catalog.forEach((it, i) => {
-    let qty = Number(form[`q_${i}`] ?? 0);
-    if (!it.allowFractional) qty = Math.floor(qty);
-    if (qty > 0) {
-      items.push({
-        quantity: qty,
-        supplierPartId: it.supplierPartId,
-        supplierPartAuxiliaryId: it.supplierPartAuxiliaryId,
-        description: it.description,
-        uom: it.uom,
-        unitPriceAmount: it.unitPrice,
-        currency: it.currency,
-        classifications: it.classifications,
-        // Keep the legacy single fields populated from the first classification
-        // for back-compat display (CartView) and any single-domain consumer.
-        classificationDomain: it.classifications[0]?.domain,
-        classification: it.classifications[0]?.value,
-        manufacturerPartId: it.manufacturerPartId,
-        manufacturerName: it.manufacturerName
+  const ctx = setupContextFor(cookie);
+  let items = [];
+  if (ctx.operation === "inspect" && ctx.items.length > 0) {
+    items = ctx.items;
+  } else {
+    catalog.forEach((it, i) => {
+      let qty = Number(form[`q_${i}`] ?? 0);
+      if (!it.allowFractional) qty = Math.floor(qty);
+      if (qty > 0) {
+        items.push({
+          quantity: qty,
+          supplierPartId: it.supplierPartId,
+          supplierPartAuxiliaryId: it.supplierPartAuxiliaryId,
+          description: it.description,
+          uom: it.uom,
+          unitPriceAmount: it.unitPrice,
+          currency: it.currency,
+          classifications: it.classifications,
+          // Keep the legacy single fields populated from the first classification
+          // for back-compat display (CartView) and any single-domain consumer.
+          classificationDomain: it.classifications[0]?.domain,
+          classification: it.classifications[0]?.value,
+          manufacturerPartId: it.manufacturerPartId,
+          manufacturerName: it.manufacturerName
+        });
+      }
+    });
+    if (ctx.operation === "edit") {
+      const extras = ctx.items.filter((p) => !catalog.some((it) => sameProduct(p, it)));
+      extras.forEach((p, j) => {
+        const qty = Number(form[`qx_${j}`] ?? p.quantity);
+        if (qty > 0) items.push({ ...p, quantity: qty });
       });
     }
-  });
+  }
   const currency = items[0]?.currency ?? "USD";
   const eff = effFor(supplier.id, buyerCred);
   const xml = buildPunchOutOrderMessage({

package/dist/web/assets/{cssMode-DipgJtey.js → cssMode-CML7oWhl.js}

@@ -1,4 +1,4 @@
-import{m as et}from"./index-ByIxIbJu.js";/*!-----------------------------------------------------------------------------
+import{m as et}from"./index-Dr4reAcK.js";/*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license

package/dist/web/assets/{freemarker2-Broesno_.js → freemarker2-DpUbnEBX.js}

@@ -1,4 +1,4 @@
-import{m as f}from"./index-ByIxIbJu.js";/*!-----------------------------------------------------------------------------
+import{m as f}from"./index-Dr4reAcK.js";/*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license

package/dist/web/assets/{handlebars-CjP6B5LA.js → handlebars-DtiE3_zM.js}

@@ -1,4 +1,4 @@
-import{m as l}from"./index-ByIxIbJu.js";/*!-----------------------------------------------------------------------------
+import{m as l}from"./index-Dr4reAcK.js";/*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license

package/dist/web/assets/{html-DRw6NWlS.js → html-D9vzMDGU.js}

@@ -1,4 +1,4 @@
-import{m as s}from"./index-ByIxIbJu.js";/*!-----------------------------------------------------------------------------
+import{m as s}from"./index-Dr4reAcK.js";/*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license

package/dist/web/assets/{htmlMode-CRd2lx43.js → htmlMode-DiAxG3yO.js}

@@ -1,4 +1,4 @@
-import{m as lt}from"./index-ByIxIbJu.js";/*!-----------------------------------------------------------------------------
+import{m as lt}from"./index-Dr4reAcK.js";/*!-----------------------------------------------------------------------------
  * Copyright (c) Microsoft Corporation. All rights reserved.
  * Version: 0.52.2(404545bded1df6ffa41ea0af4e8ddb219018c6c1)
  * Released under the MIT license