@timeax/digital-service-engine 0.3.1 → 0.3.3

package/dist/core/index.cjs

@@ -4706,141 +4706,74 @@ function toBindArray(bind) {
   return Array.isArray(bind) ? bind.slice() : [bind];
 }
 
-// src/utils/build-order-snapshot.ts
-function buildOrderSnapshot(props, builder, selection, services, settings = {}) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
-  const mode = (_a = settings.mode) != null ? _a : "prod";
-  const hostDefaultQty = Number.isFinite(
-    (_b = settings.hostDefaultQuantity) != null ? _b : 1
-  ) ? settings.hostDefaultQuantity : 1;
-  const fbSettings = {
-    requireConstraintFit: true,
-    ratePolicy: { kind: "lte_primary", pct: 5 },
-    selectionStrategy: "priority",
-    mode: mode === "dev" ? "dev" : "strict",
-    ...(_c = settings.fallback) != null ? _c : {}
-  };
-  const builtAt = (/* @__PURE__ */ new Date()).toISOString();
-  const tagId = selection.activeTagId;
-  const selectedButtonKeys = (_d = selection.selectedKeys) != null ? _d : toSelectedOptionKeys(selection.optionSelectionsByFieldId);
-  const visibleFieldIds = builder.visibleFields(
-    tagId,
-    selectedButtonKeys
-  );
-  const tagById = new Map(
-    ((_e = props.filters) != null ? _e : []).map((t) => [t.id, t])
-  );
-  const fieldById = new Map(
-    ((_f = props.fields) != null ? _f : []).map((f) => [f.id, f])
-  );
-  const tagConstraints = (_h = (_g = tagById.get(tagId)) == null ? void 0 : _g.constraints) != null ? _h : void 0;
-  const selectionFields = visibleFieldIds.map((fid) => fieldById.get(fid)).filter((f) => !!f).map((f) => {
-    var _a2;
-    const optIds = isOptionBased(f) ? (_a2 = selection.optionSelectionsByFieldId[f.id]) != null ? _a2 : [] : void 0;
+// src/utils/build-order-snapshot/fallbacks.ts
+function pruneFallbacksConservative(fallbacks, env, svcMap, policy) {
+  var _a, _b;
+  if (!fallbacks) return { pruned: void 0, original: void 0 };
+  try {
+    const { props: prunedProps } = pruneInvalidNodeFallbacks(
+      {
+        filters: [],
+        fields: [],
+        schema_version: "1.0",
+        fallbacks
+      },
+      svcMap,
+      policy
+    );
     return {
-      id: f.id,
-      type: String(f.type),
-      ...optIds && optIds.length ? { selectedOptions: optIds } : {}
+      pruned: prunedProps.fallbacks,
+      original: fallbacks
     };
-  });
-  const { formValues, selections } = buildInputs(
-    visibleFieldIds,
-    fieldById,
-    selection
-  );
-  const qtyRes = resolveQuantity(
-    visibleFieldIds,
-    fieldById,
-    tagById,
-    selection,
-    tagId,
-    hostDefaultQty
-  );
-  const quantity = qtyRes.quantity;
-  const quantitySource = qtyRes.source;
-  const { serviceMap, servicesList } = resolveServices(
-    tagId,
-    visibleFieldIds,
-    selection,
-    tagById,
-    fieldById
-  );
-  const { min, max } = resolveMinMax(servicesList, services);
-  const maybeNodeMap = typeof builder.getNodeMap === "function" ? builder.getNodeMap() : void 0;
-  const resolvedOrderKind = resolveOrderKind({
-    props,
-    activeTagId: tagId,
-    selectedTriggerKeys: selectedButtonKeys,
-    nodeMap: maybeNodeMap
-  });
-  const prunedFallbacks = pruneFallbacksConservative(
-    props.fallbacks,
-    { tagId, constraints: tagConstraints, serviceMap, servicesList },
-    services,
-    fbSettings
-  );
-  const utilities = collectUtilityLineItems(
-    visibleFieldIds,
-    fieldById,
-    selection,
-    quantity
-  );
-  const warnings = mode === "dev" ? buildDevWarnings(
-    props,
-    services,
-    tagId,
-    serviceMap,
-    prunedFallbacks.original,
-    prunedFallbacks.pruned,
-    fieldById,
-    visibleFieldIds,
-    selection
-  ) : void 0;
-  const snapshotPolicy = toSnapshotPolicy(fbSettings);
-  const meta = {
-    schema_version: props.schema_version,
-    workspaceId: settings.workspaceId,
-    builder: settings.builderCommit ? { commit: settings.builderCommit } : void 0,
-    context: {
-      tag: tagId,
-      constraints: tagConstraints != null ? tagConstraints : {},
-      nodeContexts: buildNodeContexts(
-        tagId,
-        visibleFieldIds,
-        fieldById,
-        selection
-      ),
-      policy: snapshotPolicy
+  } catch {
+    const out = {};
+    const requireFit = (_a = policy.requireConstraintFit) != null ? _a : true;
+    if (fallbacks.nodes) {
+      const keptNodes = {};
+      for (const [nodeId, candidates] of Object.entries(
+        fallbacks.nodes
+      )) {
+        if (!env.serviceMap[nodeId]) continue;
+        const primary = ((_b = env.serviceMap[nodeId]) != null ? _b : [])[0];
+        const kept = [];
+        for (const cand of candidates != null ? candidates : []) {
+          if (!rateOk(svcMap, cand, primary, policy)) continue;
+          if (requireFit && env.constraints && !constraintFitOk(svcMap, cand, env.constraints)) continue;
+          kept.push(cand);
+        }
+        if (kept.length) keptNodes[nodeId] = kept;
+      }
+      if (Object.keys(keptNodes).length) out.nodes = keptNodes;
     }
-  };
-  const snapshot = {
-    version: "1",
-    mode,
-    builtAt,
-    selection: {
-      tag: tagId,
-      buttons: selectedButtonKeys,
-      fields: selectionFields
-    },
-    inputs: {
-      form: formValues,
-      selections
-    },
-    min,
-    max: max != null ? max : min,
-    orderKind: resolvedOrderKind.kind,
-    orderKindSource: resolvedOrderKind.source,
-    quantity,
-    quantitySource,
-    services: servicesList,
-    serviceMap,
-    ...prunedFallbacks.pruned ? { fallbacks: prunedFallbacks.pruned } : {},
-    ...utilities.length ? { utilities } : {},
-    ...warnings ? { warnings } : {},
-    meta
-  };
-  return snapshot;
+    if (fallbacks.global) {
+      const keptGlobal = {};
+      const present = new Set(env.servicesList.map((sid) => String(sid)));
+      for (const [primary, cands] of Object.entries(
+        fallbacks.global
+      )) {
+        if (!present.has(String(primary))) continue;
+        const primId = isFiniteNumber2(primary) ? Number(primary) : primary;
+        const kept = [];
+        for (const cand of cands != null ? cands : []) {
+          if (!rateOk(svcMap, cand, primId, policy)) continue;
+          if (requireFit && env.constraints && !constraintFitOk(svcMap, cand, env.constraints)) continue;
+          kept.push(cand);
+        }
+        if (kept.length) keptGlobal[primId] = kept;
+      }
+      if (Object.keys(keptGlobal).length) out.global = keptGlobal;
+    }
+    return {
+      pruned: Object.keys(out).length ? out : void 0,
+      original: fallbacks
+    };
+  }
+}
+function isFiniteNumber2(v) {
+  return typeof v === "number" && Number.isFinite(v);
 }
+
+// src/utils/build-order-snapshot/selection.ts
 function isOptionBased(f) {
   const hasOptions = Array.isArray(f.options) && f.options.length > 0;
   return hasOptions || isMultiField(f);
@@ -4848,50 +4781,227 @@ function isOptionBased(f) {
 function toSelectedOptionKeys(byField) {
   const keys = [];
   for (const [fieldId, optionIds] of Object.entries(byField != null ? byField : {})) {
-    for (const optId of optionIds != null ? optionIds : []) {
-      keys.push(`${fieldId}::${optId}`);
+    for (const optionId of optionIds != null ? optionIds : []) {
+      keys.push(`${fieldId}::${optionId}`);
     }
   }
   return keys;
 }
-function isServicedBased(field) {
-  if (field.service_id) return true;
-  return !!(field.options && field.options.some((item) => item.service_id));
+function getSelectedOptionsByFieldId(selection, fieldById) {
+  const out = {};
+  for (const visit of buildSelectedNodeVisitOrder(selection, fieldById)) {
+    if (visit.kind !== "option") continue;
+    if (!out[visit.fieldId]) out[visit.fieldId] = [];
+    out[visit.fieldId].push(visit.optionId);
+  }
+  return out;
+}
+function buildSelectedNodeVisitOrder(selection, fieldById) {
+  var _a, _b, _c;
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  function pushField(fieldId) {
+    const key = `field:${fieldId}`;
+    if (seen.has(key)) return;
+    seen.add(key);
+    out.push({ kind: "field", fieldId });
+  }
+  function pushOption(fieldId, optionId) {
+    const key = `option:${fieldId}::${optionId}`;
+    if (seen.has(key)) return;
+    seen.add(key);
+    out.push({ kind: "option", fieldId, optionId });
+  }
+  for (const item of (_a = selection.optionTraversalOrder) != null ? _a : []) {
+    pushOption(item.fieldId, item.optionId);
+  }
+  for (const rawKey of (_b = selection.selectedKeys) != null ? _b : []) {
+    const key = String(rawKey);
+    if (key.includes("::")) {
+      const [fieldId, optionId] = key.split("::", 2);
+      if (fieldId && optionId) pushOption(fieldId, optionId);
+      continue;
+    }
+    const field = fieldById.get(key);
+    if (field) {
+      pushField(field.id);
+      continue;
+    }
+    const ownerField = findOptionOwnerField(key, fieldById);
+    if (ownerField) pushOption(ownerField.id, key);
+  }
+  for (const [fieldId, optionIds] of Object.entries(
+    (_c = selection.optionSelectionsByFieldId) != null ? _c : {}
+  )) {
+    if (!fieldById.has(fieldId)) continue;
+    for (const optionId of optionIds != null ? optionIds : []) {
+      pushOption(fieldId, optionId);
+    }
+  }
+  return out;
+}
+function findOptionOwnerField(optionId, fieldById) {
+  var _a;
+  for (const field of fieldById.values()) {
+    if ((_a = field.options) == null ? void 0 : _a.some((option) => option.id === optionId)) return field;
+  }
+  return void 0;
+}
+
+// src/utils/build-order-snapshot/services.ts
+function isServiceBased(field) {
+  var _a;
+  if (field.service_id !== void 0 && field.service_id !== null) return true;
+  return !!((_a = field.options) == null ? void 0 : _a.some(
+    (item) => item.service_id !== void 0 && item.service_id !== null
+  ));
 }
-function buildInputs(visibleFieldIds, fieldById, selection) {
+function resolveServices(tagId, visibleFieldIds, selection, tagById, fieldById, services) {
+  var _a, _b, _c, _d;
+  const serviceMap = {};
+  const visible = new Set(visibleFieldIds);
+  const selectedBaseServices = [];
+  const visits = buildSelectedNodeVisitOrder(selection, fieldById);
+  let index = 0;
+  function addSelectedBaseService(origin, sid) {
+    pushService(serviceMap, origin, sid);
+    selectedBaseServices.push({
+      origin,
+      sid,
+      rate: readServiceRate(services, sid),
+      index: index++
+    });
+  }
+  for (const visit of visits) {
+    if (!visible.has(visit.fieldId)) continue;
+    const field = fieldById.get(visit.fieldId);
+    if (!field) continue;
+    if (visit.kind === "field") {
+      const role2 = (_a = field.pricing_role) != null ? _a : "base";
+      if (role2 === "utility") continue;
+      if (field.service_id !== void 0 && field.service_id !== null) {
+        addSelectedBaseService(field.id, field.service_id);
+      }
+      continue;
+    }
+    const option = (_b = field.options) == null ? void 0 : _b.find((item) => item.id === visit.optionId);
+    if (!option) continue;
+    const role = (_d = (_c = option.pricing_role) != null ? _c : field.pricing_role) != null ? _d : "base";
+    if (role === "utility") continue;
+    if (option.service_id !== void 0 && option.service_id !== null) {
+      addSelectedBaseService(option.id, option.service_id);
+    }
+  }
+  if (selectedBaseServices.length > 0) {
+    const primary = pickHighestRatePrimary2(selectedBaseServices);
+    const ordered = [
+      primary.sid,
+      ...selectedBaseServices.filter((item) => item !== primary).sort((a, b) => a.index - b.index).map((item) => item.sid)
+    ];
+    return { serviceMap, servicesList: dedupeByString(ordered) };
+  }
+  const tag = tagById.get(tagId);
+  if ((tag == null ? void 0 : tag.service_id) !== void 0 && tag.service_id !== null) {
+    pushService(serviceMap, tagId, tag.service_id);
+    return { serviceMap, servicesList: [tag.service_id] };
+  }
+  return { serviceMap, servicesList: [] };
+}
+function pickHighestRatePrimary2(services) {
+  let best = services[0];
+  for (const item of services.slice(1)) {
+    if (item.rate > best.rate) best = item;
+  }
+  return best;
+}
+function getCap2(map, id) {
+  var _a;
+  return (_a = map == null ? void 0 : map[id]) != null ? _a : map == null ? void 0 : map[String(id)];
+}
+function readServiceRate(services, sid) {
+  var _a;
+  const rate = Number((_a = getCap2(services, sid)) == null ? void 0 : _a.rate);
+  return Number.isFinite(rate) ? rate : Number.NEGATIVE_INFINITY;
+}
+function pushService(map, nodeId, sid) {
+  if (!map[nodeId]) map[nodeId] = [];
+  map[nodeId].push(sid);
+}
+function dedupeByString(arr) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const value of arr) {
+    const key = String(value);
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(value);
+  }
+  return out;
+}
+
+// src/utils/build-order-snapshot/inputs.ts
+function buildInputs(visibleFieldIds, fieldById, selection, selectedOptionsByFieldId) {
   const formValues = {};
   const selections = {};
   for (const fid of visibleFieldIds) {
-    const f = fieldById.get(fid);
-    if (!f) continue;
-    const selOptIds = selection.optionSelectionsByFieldId[fid];
-    if (selOptIds && selOptIds.length) {
-      selections[fid] = [...selOptIds];
-    }
-    if (!isServicedBased(f)) {
-      const name = f.name;
-      const val = selection.formValuesByFieldId[fid];
-      if (!name || val === void 0) continue;
-      formValues[name] = val;
+    const field = fieldById.get(fid);
+    if (!field) continue;
+    const selectedOptionIds = selectedOptionsByFieldId[fid];
+    if (selectedOptionIds == null ? void 0 : selectedOptionIds.length) selections[fid] = [...selectedOptionIds];
+    if (!isServiceBased(field)) {
+      const name = field.name;
+      const value = selection.formValuesByFieldId[fid];
+      if (!name || value === void 0) continue;
+      formValues[name] = value;
     }
   }
   return { formValues, selections };
 }
+
+// src/utils/build-order-snapshot/min-max.ts
+function getCap3(map, id) {
+  var _a;
+  return (_a = map == null ? void 0 : map[id]) != null ? _a : map == null ? void 0 : map[String(id)];
+}
+function resolveMinMax(servicesList, services) {
+  let min;
+  let max;
+  for (const sid of servicesList) {
+    const cap = getCap3(services, sid);
+    if (!cap) continue;
+    if (typeof cap.min === "number" && Number.isFinite(cap.min)) {
+      min = min === void 0 ? cap.min : Math.min(min, cap.min);
+    }
+    if (typeof cap.max === "number" && Number.isFinite(cap.max)) {
+      max = max === void 0 ? cap.max : Math.max(max, cap.max);
+    }
+  }
+  return { min: min != null ? min : 1, ...max !== void 0 ? { max } : {} };
+}
+
+// src/utils/build-order-snapshot/policy.ts
+function toSnapshotPolicy(settings) {
+  var _a;
+  return {
+    ratePolicy: normalizeRatePolicy(settings.ratePolicy),
+    requireConstraintFit: (_a = settings.requireConstraintFit) != null ? _a : true
+  };
+}
+
+// src/utils/build-order-snapshot/quantity.ts
 function resolveQuantity(visibleFieldIds, fieldById, tagById, selection, tagId, hostDefault) {
   var _a;
   for (const fid of visibleFieldIds) {
-    const f = fieldById.get(fid);
-    if (!f) continue;
-    const rule = readQuantityRule(
-      (_a = f.meta) == null ? void 0 : _a.quantity
-    );
+    const field = fieldById.get(fid);
+    if (!field) continue;
+    const rule = readQuantityRule((_a = field.meta) == null ? void 0 : _a.quantity);
     if (!rule) continue;
     const raw = selection.formValuesByFieldId[fid];
     const evaluated = evaluateQuantityRule(rule, raw);
     if (Number.isFinite(evaluated) && evaluated > 0) {
       return {
         quantity: evaluated,
-        source: { kind: "field", id: f.id, rule }
+        source: { kind: "field", id: field.id, rule }
       };
     }
     break;
@@ -4904,24 +5014,47 @@ function resolveQuantity(visibleFieldIds, fieldById, tagById, selection, tagId,
     tagId
   );
   if (nodeDefault) return nodeDefault;
-  return {
-    quantity: hostDefault,
-    source: { kind: "default", defaultedFromHost: true }
-  };
+  return { quantity: hostDefault, source: { kind: "default", defaultedFromHost: true } };
+}
+function resolveNodeDefaultQuantity(visibleFieldIds, fieldById, tagById, selection, tagId) {
+  var _a, _b, _c;
+  const visible = new Set(visibleFieldIds);
+  const visits = buildSelectedNodeVisitOrder(selection, fieldById);
+  for (const visit of visits) {
+    if (visit.kind !== "option") continue;
+    if (!visible.has(visit.fieldId)) continue;
+    const field = fieldById.get(visit.fieldId);
+    if (!((_a = field == null ? void 0 : field.options) == null ? void 0 : _a.length)) continue;
+    const option = field.options.find((item) => item.id === visit.optionId);
+    const quantity = readPositiveFiniteNumber((_b = option == null ? void 0 : option.meta) == null ? void 0 : _b.quantityDefault);
+    if (quantity !== void 0) {
+      return { quantity, source: { kind: "option", id: option.id } };
+    }
+  }
+  for (const visit of visits) {
+    if (!visible.has(visit.fieldId)) continue;
+    const field = fieldById.get(visit.fieldId);
+    if (!field) continue;
+    const quantity = readPositiveFiniteNumber(field.quantityDefault);
+    if (quantity !== void 0) {
+      return { quantity, source: { kind: "field", id: field.id } };
+    }
+  }
+  const tag = tagById.get(tagId);
+  const tagQuantity = readPositiveFiniteNumber((_c = tag == null ? void 0 : tag.meta) == null ? void 0 : _c.quantityDefault);
+  if (tagQuantity !== void 0) {
+    return { quantity: tagQuantity, source: { kind: "tag", id: tagId } };
+  }
+  return void 0;
 }
 function readQuantityRule(v) {
   if (!v || typeof v !== "object") return void 0;
   const src = v;
-  if (src.valueBy !== "value" && src.valueBy !== "length" && src.valueBy !== "eval")
-    return void 0;
+  if (src.valueBy !== "value" && src.valueBy !== "length" && src.valueBy !== "eval") return void 0;
   const out = { valueBy: src.valueBy };
   if (src.code && typeof src.code === "string") out.code = src.code;
-  if (typeof src.multiply === "number" && Number.isFinite(src.multiply)) {
-    out.multiply = src.multiply;
-  }
-  if (typeof src.fallback === "number" && Number.isFinite(src.fallback)) {
-    out.fallback = src.fallback;
-  }
+  if (typeof src.multiply === "number" && Number.isFinite(src.multiply)) out.multiply = src.multiply;
+  if (typeof src.fallback === "number" && Number.isFinite(src.fallback)) out.fallback = src.fallback;
   if (src.clamp && typeof src.clamp === "object") {
     const min = typeof src.clamp.min === "number" && Number.isFinite(src.clamp.min) ? src.clamp.min : void 0;
     const max = typeof src.clamp.max === "number" && Number.isFinite(src.clamp.max) ? src.clamp.max : void 0;
@@ -4992,231 +5125,43 @@ function applyClamp(value, clamp2) {
   if ((clamp2 == null ? void 0 : clamp2.max) !== void 0) next = Math.min(next, clamp2.max);
   return next;
 }
-function resolveNodeDefaultQuantity(visibleFieldIds, fieldById, tagById, selection, tagId) {
-  var _a, _b, _c, _d;
-  const optionVisit = buildOptionVisitOrder(selection, fieldById);
-  for (const { fieldId, optionId } of optionVisit) {
-    if (!visibleFieldIds.includes(fieldId)) continue;
-    const field = fieldById.get(fieldId);
-    const option = (_a = field == null ? void 0 : field.options) == null ? void 0 : _a.find((item) => item.id === optionId);
-    const quantityDefault = readQuantityDefault(
-      (_b = option == null ? void 0 : option.meta) == null ? void 0 : _b.quantityDefault
-    );
-    if (quantityDefault !== void 0) {
-      return {
-        quantity: quantityDefault,
-        source: { kind: "option", id: optionId }
-      };
-    }
-  }
-  for (const fieldId of visibleFieldIds) {
-    const field = fieldById.get(fieldId);
-    if (!field) continue;
-    const isButtonStyle = field.button === true || Array.isArray(field.options) && field.options.length > 0;
-    if (!isButtonStyle) continue;
-    const quantityDefault = readQuantityDefault(
-      field.quantityDefault
-    );
-    if (quantityDefault !== void 0) {
-      return {
-        quantity: quantityDefault,
-        source: { kind: "field", id: field.id }
-      };
-    }
-  }
-  const tagQuantityDefault = readQuantityDefault(
-    (_d = (_c = tagById.get(tagId)) == null ? void 0 : _c.meta) == null ? void 0 : _d.quantityDefault
-  );
-  if (tagQuantityDefault !== void 0) {
-    return {
-      quantity: tagQuantityDefault,
-      source: { kind: "tag", id: tagId }
-    };
-  }
-  return void 0;
-}
-function readQuantityDefault(value) {
-  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
-}
-function resolveServices(tagId, visibleFieldIds, selection, tagById, fieldById) {
-  var _a;
-  const serviceMap = {};
-  const ordered = [];
-  const tag = tagById.get(tagId);
-  let primary;
-  let primaryOrigin;
-  if ((tag == null ? void 0 : tag.service_id) !== void 0) {
-    primary = tag.service_id;
-    primaryOrigin = "tag";
-  }
-  const optionVisit = buildOptionVisitOrder(selection, fieldById);
-  for (const { fieldId, optionId } of optionVisit) {
-    if (!visibleFieldIds.includes(fieldId)) continue;
-    const f = fieldById.get(fieldId);
-    if (!f || !Array.isArray(f.options)) continue;
-    const opt = f.options.find((o) => o.id === optionId);
-    if (!opt) continue;
-    const role = (_a = opt.pricing_role) != null ? _a : "base";
-    const sid = opt.service_id;
-    if (role === "utility") continue;
-    if (sid !== void 0) {
-      if (primary === void 0 || primaryOrigin === "tag") {
-        primary = sid;
-        primaryOrigin = "option";
-        ordered.length = 0;
-        ordered.push(primary);
-      } else {
-        ordered.push(sid);
-      }
-      pushService(serviceMap, optionId, sid);
-    }
-  }
-  if (primaryOrigin !== "option" && primary !== void 0) {
-    ordered.unshift(primary);
-    pushService(serviceMap, tagId, primary);
-  } else {
-  }
-  const servicesList = dedupeByString(ordered);
-  return { serviceMap, servicesList };
-}
-function buildOptionVisitOrder(selection, fieldById) {
-  var _a;
-  if (selection.optionTraversalOrder && selection.optionTraversalOrder.length) {
-    return selection.optionTraversalOrder.slice();
-  }
-  const out = [];
-  for (const [fid, optIds] of Object.entries(
-    (_a = selection.optionSelectionsByFieldId) != null ? _a : {}
-  )) {
-    const f = fieldById.get(fid);
-    if (!f) continue;
-    for (const oid of optIds != null ? optIds : [])
-      out.push({ fieldId: fid, optionId: oid });
-  }
-  return out;
-}
-function pushService(map, nodeId, sid) {
-  if (!map[nodeId]) map[nodeId] = [];
-  map[nodeId].push(sid);
-}
-function dedupeByString(arr) {
-  const s = /* @__PURE__ */ new Set();
-  const out = [];
-  for (const v of arr) {
-    const key = String(v);
-    if (s.has(key)) continue;
-    s.add(key);
-    out.push(v);
-  }
-  return out;
-}
-function pruneFallbacksConservative(fallbacks, env, svcMap, policy) {
-  var _a, _b;
-  if (!fallbacks) return { pruned: void 0, original: void 0 };
-  try {
-    const { props: prunedProps } = pruneInvalidNodeFallbacks(
-      {
-        filters: [],
-        fields: [],
-        schema_version: "1.0",
-        fallbacks
-      },
-      svcMap,
-      policy
-    );
-    return {
-      pruned: prunedProps.fallbacks,
-      original: fallbacks
-    };
-  } catch {
-    const out = {};
-    const requireFit = (_a = policy.requireConstraintFit) != null ? _a : true;
-    if (fallbacks.nodes) {
-      const keptNodes = {};
-      for (const [nodeId, candidates] of Object.entries(
-        fallbacks.nodes
-      )) {
-        if (!env.serviceMap[nodeId]) continue;
-        const primary = ((_b = env.serviceMap[nodeId]) != null ? _b : [])[0];
-        const kept = [];
-        for (const cand of candidates != null ? candidates : []) {
-          if (!rateOk(svcMap, cand, primary, policy)) continue;
-          if (requireFit && env.constraints && !constraintFitOk(svcMap, cand, env.constraints))
-            continue;
-          kept.push(cand);
-        }
-        if (kept.length) keptNodes[nodeId] = kept;
-      }
-      if (Object.keys(keptNodes).length) out.nodes = keptNodes;
-    }
-    if (fallbacks.global) {
-      const keptGlobal = {};
-      const present = new Set(env.servicesList.map((sid) => String(sid)));
-      for (const [primary, cands] of Object.entries(
-        fallbacks.global
-      )) {
-        if (!present.has(String(primary))) continue;
-        const primId = isFiniteNumber2(primary) ? Number(primary) : primary;
-        const kept = [];
-        for (const cand of cands != null ? cands : []) {
-          if (!rateOk(svcMap, cand, primId, policy)) continue;
-          if (requireFit && env.constraints && !constraintFitOk(svcMap, cand, env.constraints))
-            continue;
-          kept.push(cand);
-        }
-        if (kept.length) keptGlobal[primId] = kept;
-      }
-      if (Object.keys(keptGlobal).length)
-        out.global = keptGlobal;
-    }
-    return {
-      pruned: Object.keys(out).length ? out : void 0,
-      original: fallbacks
-    };
-  }
-}
-function isFiniteNumber2(v) {
-  return typeof v === "number" && Number.isFinite(v);
+function readPositiveFiniteNumber(value) {
+  const n = Number(value);
+  return Number.isFinite(n) && n > 0 ? n : void 0;
 }
-function collectUtilityLineItems(visibleFieldIds, fieldById, selection, quantity) {
+
+// src/utils/build-order-snapshot/utilities.ts
+function collectUtilityLineItems(visibleFieldIds, fieldById, selection, selectedOptionsByFieldId, quantity) {
   var _a, _b, _c, _d, _e;
   const items = [];
   for (const fid of visibleFieldIds) {
-    const f = fieldById.get(fid);
-    if (!f) continue;
-    const isUtilityField = ((_a = f.pricing_role) != null ? _a : "base") === "utility";
-    const marker = readUtilityMarker((_b = f.meta) == null ? void 0 : _b.utility);
+    const field = fieldById.get(fid);
+    if (!field) continue;
+    const isUtilityField = ((_a = field.pricing_role) != null ? _a : "base") === "utility";
+    const marker = readUtilityMarker((_b = field.meta) == null ? void 0 : _b.utility);
     if (isUtilityField && marker) {
-      const val = selection.formValuesByFieldId[f.id];
-      const item = buildUtilityItemFromMarker(
-        f.id,
-        marker,
-        quantity,
-        val
-      );
+      const value = selection.formValuesByFieldId[field.id];
+      const item = buildUtilityItemFromMarker(field.id, marker, quantity, value);
       if (item) items.push(item);
     }
-    if (Array.isArray(f.options) && f.options.length) {
-      const selectedOptIds = (_c = selection.optionSelectionsByFieldId[f.id]) != null ? _c : [];
-      if (selectedOptIds.length) {
-        const optById = new Map(
-          f.options.map((o) => [o.id, o])
+    if (Array.isArray(field.options) && field.options.length) {
+      const selectedOptionIds = (_c = selectedOptionsByFieldId[field.id]) != null ? _c : [];
+      if (!selectedOptionIds.length) continue;
+      const optById = new Map(field.options.map((o) => [o.id, o]));
+      for (const oid of selectedOptionIds) {
+        const option = optById.get(oid);
+        if (!option) continue;
+        if (((_d = option.pricing_role) != null ? _d : "base") !== "utility") continue;
+        const optionMarker = readUtilityMarker((_e = option.meta) == null ? void 0 : _e.utility);
+        if (!optionMarker) continue;
+        const parentValue = selection.formValuesByFieldId[field.id];
+        const item = buildUtilityItemFromMarker(
+          option.id,
+          optionMarker,
+          quantity,
+          parentValue
         );
-        for (const oid of selectedOptIds) {
-          const opt = optById.get(oid);
-          if (!opt) continue;
-          if (((_d = opt.pricing_role) != null ? _d : "base") !== "utility") continue;
-          const om = readUtilityMarker((_e = opt.meta) == null ? void 0 : _e.utility);
-          if (!om) continue;
-          const parentVal = selection.formValuesByFieldId[f.id];
-          const item = buildUtilityItemFromMarker(
-            opt.id,
-            om,
-            quantity,
-            parentVal
-          );
-          if (item) items.push(item);
-        }
+        if (item) items.push(item);
       }
     }
   }
@@ -5225,19 +5170,16 @@ function collectUtilityLineItems(visibleFieldIds, fieldById, selection, quantity
 function readUtilityMarker(v) {
   if (!v || typeof v !== "object") return void 0;
   const src = v;
-  if (!src.mode || typeof src.rate !== "number" || !Number.isFinite(src.rate))
-    return void 0;
-  if (src.mode !== "flat" && src.mode !== "per_quantity" && src.mode !== "per_value" && src.mode !== "percent")
+  if (!src.mode || typeof src.rate !== "number" || !Number.isFinite(src.rate)) return void 0;
+  if (src.mode !== "flat" && src.mode !== "per_quantity" && src.mode !== "per_value" && src.mode !== "percent") {
     return void 0;
+  }
   const out = { mode: src.mode, rate: src.rate };
-  if (src.valueBy === "value" || src.valueBy === "length")
-    out.valueBy = src.valueBy;
+  if (src.valueBy === "value" || src.valueBy === "length") out.valueBy = src.valueBy;
   if (src.percentBase === "service_total" || src.percentBase === "base_service" || src.percentBase === "all") {
     out.percentBase = src.percentBase;
   }
-  if (typeof src.label === "string" && src.label.trim()) {
-    out.label = src.label.trim();
-  }
+  if (typeof src.label === "string" && src.label.trim()) out.label = src.label.trim();
   return out;
 }
 function buildUtilityItemFromMarker(nodeId, marker, quantity, value) {
@@ -5260,17 +5202,19 @@ function buildUtilityItemFromMarker(nodeId, marker, quantity, value) {
   }
   return base;
 }
-function buildNodeContexts(tagId, visibleFieldIds, fieldById, selection) {
+
+// src/utils/build-order-snapshot/context.ts
+function buildNodeContexts(tagId, visibleFieldIds, fieldById, _selection, selectedOptionsByFieldId) {
   var _a;
   const ctx = {};
   ctx[tagId] = tagId;
   for (const fid of visibleFieldIds) {
-    const f = fieldById.get(fid);
-    if (!f) continue;
-    const binds = normalizeBindIds(f.bind_id);
+    const field = fieldById.get(fid);
+    if (!field) continue;
+    const binds = normalizeBindIds(field.bind_id);
     const applicable = binds.has(tagId);
-    const selectedOptIds = (_a = selection.optionSelectionsByFieldId[fid]) != null ? _a : [];
-    for (const oid of selectedOptIds) {
+    const selectedOptionIds = (_a = selectedOptionsByFieldId[fid]) != null ? _a : [];
+    for (const oid of selectedOptionIds) {
       ctx[oid] = applicable ? tagId : null;
     }
   }
@@ -5286,66 +5230,159 @@ function normalizeBindIds(bind) {
   }
   return out;
 }
-function buildDevWarnings(props, svcMap, _tagId, _snapshotServiceMap, originalFallbacks, _prunedFallbacks, fieldById, visibleFieldIds, selection) {
+
+// src/utils/build-order-snapshot/warnings.ts
+function buildDevWarnings(props, svcMap, originalFallbacks, fieldById, visibleFieldIds, selection) {
   const out = {};
   const maybeCollectFailed = globalThis.collectFailedFallbacks;
   try {
     if (maybeCollectFailed && originalFallbacks) {
       const diags = maybeCollectFailed(
-        {
-          ...props,
-          fallbacks: originalFallbacks
-        },
+        { ...props, fallbacks: originalFallbacks },
         svcMap,
         { mode: "dev" }
       );
-      if (diags && diags.length) {
-        out.fallbacks = diags;
-      }
+      if (diags == null ? void 0 : diags.length) out.fallbacks = diags;
     }
   } catch {
   }
   const utilityWarnings = [];
   for (const fid of visibleFieldIds) {
-    const f = fieldById.get(fid);
-    if (!f) continue;
-    const hasVal = selection.formValuesByFieldId[fid] !== void 0;
-    if (hasVal && !f.name && !isOptionBased(f)) {
+    const field = fieldById.get(fid);
+    if (!field) continue;
+    const hasValue = selection.formValuesByFieldId[fid] !== void 0;
+    if (hasValue && !field.name && !isOptionBased(field)) {
       utilityWarnings.push({
         nodeId: fid,
         reason: "missing_field_name_for_form_value"
       });
     }
   }
-  if (utilityWarnings.length) {
-    out.utility = utilityWarnings;
-  }
+  if (utilityWarnings.length) out.utility = utilityWarnings;
   if (!out.fallbacks && !out.utility) return void 0;
   return out;
 }
-function toSnapshotPolicy(settings) {
-  var _a;
-  const requireConstraintFit = (_a = settings.requireConstraintFit) != null ? _a : true;
-  const rp = normalizeRatePolicy(settings.ratePolicy);
-  return { ratePolicy: rp, requireConstraintFit };
-}
-function getCap2(map, id) {
-  return getServiceCapability(map, id);
-}
-function resolveMinMax(servicesList, services) {
-  let min = void 0;
-  let max = void 0;
-  for (const sid of servicesList) {
-    const cap = getCap2(services, sid);
-    if (!cap) continue;
-    if (typeof cap.min === "number" && Number.isFinite(cap.min)) {
-      min = min === void 0 ? cap.min : Math.min(min, cap.min);
-    }
-    if (typeof cap.max === "number" && Number.isFinite(cap.max)) {
-      max = max === void 0 ? cap.max : Math.max(max, cap.max);
+
+// src/utils/build-order-snapshot/index.ts
+function buildOrderSnapshot(props, builder, selection, services, settings = {}) {
+  var _a, _b, _c, _d, _e, _f, _g, _h;
+  const mode = (_a = settings.mode) != null ? _a : "prod";
+  const hostDefaultQty = Number.isFinite((_b = settings.hostDefaultQuantity) != null ? _b : 1) ? settings.hostDefaultQuantity : 1;
+  const fbSettings = {
+    requireConstraintFit: true,
+    ratePolicy: { kind: "lte_primary", pct: 5 },
+    selectionStrategy: "priority",
+    mode: mode === "dev" ? "dev" : "strict",
+    ...(_c = settings.fallback) != null ? _c : {}
+  };
+  const builtAt = (/* @__PURE__ */ new Date()).toISOString();
+  const tagId = selection.activeTagId;
+  const selectedButtonKeys = (_d = selection.selectedKeys) != null ? _d : toSelectedOptionKeys(selection.optionSelectionsByFieldId);
+  const visibleFieldIds = builder.visibleFields(tagId, selectedButtonKeys);
+  const tagById = new Map(((_e = props.filters) != null ? _e : []).map((t) => [t.id, t]));
+  const fieldById = new Map(((_f = props.fields) != null ? _f : []).map((f) => [f.id, f]));
+  const tagConstraints = (_h = (_g = tagById.get(tagId)) == null ? void 0 : _g.constraints) != null ? _h : void 0;
+  const selectedOptionsByFieldId = getSelectedOptionsByFieldId(selection, fieldById);
+  const selectionFields = visibleFieldIds.map((fid) => fieldById.get(fid)).filter((f) => !!f).map((f) => {
+    var _a2;
+    const optionIds = isOptionBased(f) ? (_a2 = selectedOptionsByFieldId[f.id]) != null ? _a2 : [] : void 0;
+    return {
+      id: f.id,
+      type: String(f.type),
+      ...optionIds && optionIds.length ? { selectedOptions: optionIds } : {}
+    };
+  });
+  const { formValues, selections } = buildInputs(
+    visibleFieldIds,
+    fieldById,
+    selection,
+    selectedOptionsByFieldId
+  );
+  const qtyRes = resolveQuantity(
+    visibleFieldIds,
+    fieldById,
+    tagById,
+    selection,
+    tagId,
+    hostDefaultQty
+  );
+  const { serviceMap, servicesList } = resolveServices(
+    tagId,
+    visibleFieldIds,
+    selection,
+    tagById,
+    fieldById,
+    services
+  );
+  const { min, max } = resolveMinMax(servicesList, services);
+  const maybeNodeMap = typeof builder.getNodeMap === "function" ? builder.getNodeMap() : void 0;
+  const resolvedOrderKind = resolveOrderKind({
+    props,
+    activeTagId: tagId,
+    selectedTriggerKeys: selectedButtonKeys,
+    nodeMap: maybeNodeMap
+  });
+  const prunedFallbacks = pruneFallbacksConservative(
+    props.fallbacks,
+    { tagId, constraints: tagConstraints, serviceMap, servicesList },
+    services,
+    fbSettings
+  );
+  const utilities = collectUtilityLineItems(
+    visibleFieldIds,
+    fieldById,
+    selection,
+    selectedOptionsByFieldId,
+    qtyRes.quantity
+  );
+  const warnings = mode === "dev" ? buildDevWarnings(
+    props,
+    services,
+    prunedFallbacks.original,
+    fieldById,
+    visibleFieldIds,
+    selection
+  ) : void 0;
+  const meta = {
+    schema_version: props.schema_version,
+    workspaceId: settings.workspaceId,
+    builder: settings.builderCommit ? { commit: settings.builderCommit } : void 0,
+    context: {
+      tag: tagId,
+      constraints: tagConstraints != null ? tagConstraints : {},
+      nodeContexts: buildNodeContexts(
+        tagId,
+        visibleFieldIds,
+        fieldById,
+        selection,
+        selectedOptionsByFieldId
+      ),
+      policy: toSnapshotPolicy(fbSettings)
     }
-  }
-  return { min: min != null ? min : 1, ...max !== void 0 ? { max } : {} };
+  };
+  return {
+    version: "1",
+    mode,
+    builtAt,
+    selection: {
+      tag: tagId,
+      buttons: selectedButtonKeys,
+      fields: selectionFields
+    },
+    inputs: { form: formValues, selections },
+    min,
+    max: max != null ? max : min,
+    orderKind: resolvedOrderKind.kind,
+    orderKindSource: resolvedOrderKind.source,
+    quantity: qtyRes.quantity,
+    quantitySource: qtyRes.source,
+    services: servicesList,
+    serviceMap,
+    ...prunedFallbacks.pruned ? { fallbacks: prunedFallbacks.pruned } : {},
+    ...utilities.length ? { utilities } : {},
+    ...warnings ? { warnings } : {},
+    meta
+  };
 }
 
 // src/core/fallback-editor.ts