@asteby/storefront 0.17.0 → 0.18.1

package/dist/index.cjs

@@ -124,9 +124,14 @@ function appendParams(search, params) {
   return search;
 }
 function productListQuery(params = {}) {
-  const { filters, handles, ...rest } = params;
+  const { filters, handles, tags_any, ...rest } = params;
   const search = appendParams(new URLSearchParams(), rest);
   if (handles && handles.length > 0) search.set("handles", handles.join(","));
+  if (tags_any && tags_any.length > 0) {
+    if (tags_any.length > 5) throw new RangeError("tags_any takes at most 5 tags");
+    if (tags_any.some((t) => t.includes(",") || t.length > 120)) throw new TypeError("tags_any: a tag has at most 120 characters and no comma");
+    search.set("tags_any", tags_any.join(","));
+  }
   if (filters) {
     for (const [key, raw] of Object.entries(filters)) {
       const name = key.startsWith("filter.") ? key : `filter.${key}`;
@@ -573,6 +578,19 @@ function createStorefrontClient(config) {
         /** Physical delete (a profile leaves nothing behind). A saved default passes to another profile. */
         delete: (id, options) => write("DELETE", `/storefront/customer/fiscal-profiles/${enc(id)}`, void 0, options)
       },
+      /**
+       * Saved items of the buyer («My items», «My garage»; contract 1.9, `capabilities().subjects`). Personal data:
+       * private, never cached, never logged. `422` with `field: 'attributes.<field>'` when the kind refuses a value
+       * (it never echoes it); `409` for an item already saved or past the limit; `429` for too many saves; `404` for
+       * an item that is not the buyer's. The server builds `label` and `fit_key`; private fields come back masked.
+       */
+      subjects: {
+        list: async (params, options) => (await get("/storefront/customer/subjects", params, { ...options, cache: "no-store" })).nodes,
+        create: (input, options) => write("POST", "/storefront/customer/subjects", input, options),
+        update: (id, patch, options) => write("PATCH", `/storefront/customer/subjects/${enc(id)}`, patch, options),
+        /** Physical delete (the item leaves nothing behind). The default of its kind passes to another item. */
+        delete: (id, options) => write("DELETE", `/storefront/customer/subjects/${enc(id)}`, void 0, options)
+      },
       addresses: {
         list: (options) => get("/storefront/customer/addresses", void 0, options),
         create: (address, options) => write("POST", "/storefront/customer/addresses", address, options),
@@ -581,6 +599,11 @@ function createStorefrontClient(config) {
       }
     },
     content: {
+      /**
+       * The kinds of buyer item the organization declares («My garage») and their catalogs (contract 1.9; public,
+       * cacheable). `[]` when it declares none or the server predates the route: the store has no such section.
+       */
+      subjectKinds: async (options) => (await getOrNull("/storefront/subject-kinds", void 0, options))?.nodes ?? [],
       theme: (options) => get("/storefront/content/theme", void 0, options),
       /** `null` when the page does not exist. */
       page: (handle, options) => getOrNull(`/storefront/content/pages/${enc(handle)}`, previewQuery(options), options),
@@ -1538,6 +1561,199 @@ function safeInvoiceFilename(name, fallback = "factura") {
   return clean || fallback;
 }
 
+// src/subjects.ts
+var MIN_SUBJECT_YEAR = 1900;
+var MAX_SUBJECT_YEAR = 2100;
+var MAX_VALUE_LENGTH = 80;
+var MAX_LABEL_LENGTH = 120;
+var MAX_FIT_KEY_LENGTH = 100;
+var isPresent = (v) => v !== null && v !== void 0 && v !== "";
+var asYear = (v) => {
+  const n = typeof v === "number" ? v : typeof v === "string" && /^\s*\d+\s*$/.test(v) ? Number(v) : NaN;
+  return Number.isInteger(n) && n >= MIN_SUBJECT_YEAR && n <= MAX_SUBJECT_YEAR ? n : null;
+};
+var cleanText = (v, max) => {
+  if (typeof v !== "string") return null;
+  const s = v.split(/\s+/).filter(Boolean).join(" ");
+  return [...s].length > max || /[\u0000-\u001f\u007f-\u009f]/.test(s) ? null : s;
+};
+var slug = (s) => s.toLowerCase().replace(/[^a-z0-9._+-]+/g, "-").replace(/^-+|-+$/g, "");
+function coversYear(node, year) {
+  if (node.ranges && node.ranges.length > 0) return node.ranges.some(([a, b]) => year >= a && year <= b);
+  if (node.from !== void 0 && year < node.from) return false;
+  if (node.to !== void 0 && year > node.to) return false;
+  return true;
+}
+var declaresYears = (n) => n.from !== void 0 || n.to !== void 0 || (n.ranges?.length ?? 0) > 0;
+function subjectLevels(kind) {
+  return kind.fields.filter((f) => f.source === "catalog" && f.type !== "year");
+}
+function subjectFields(kind) {
+  return kind.fields;
+}
+function walk(kind, values) {
+  const path = [];
+  const ids = {};
+  let tree = kind.catalog?.tree;
+  for (const f of subjectLevels(kind)) {
+    const raw = values[f.key];
+    const s = isPresent(raw) ? cleanText(raw, MAX_VALUE_LENGTH) : null;
+    const node = s && tree ? tree[s] ?? tree[s.toLowerCase()] : void 0;
+    if (!s || !node) return { path, ids, next: tree };
+    ids[f.key] = tree && tree[s] ? s : s.toLowerCase();
+    path.push(node);
+    tree = node.children;
+    if (!tree) return { path, ids, next: void 0 };
+  }
+  return { path, ids, next: tree };
+}
+var byLabel = (a, b) => a.label.localeCompare(b.label, void 0, { sensitivity: "base", numeric: true });
+function subjectOptions(kind, fieldKey, values) {
+  const field = kind.fields.find((f) => f.key === fieldKey);
+  if (!field || field.source !== "catalog" || !kind.catalog) return [];
+  if (field.type === "year") {
+    const upto = kind.fields.slice(0, kind.fields.indexOf(field));
+    const { path: path2 } = walk({ ...kind, fields: upto }, values);
+    const declared = path2.filter(declaresYears);
+    if (declared.length === 0) return [];
+    let lo = Infinity;
+    let hi = -Infinity;
+    for (const n of declared) {
+      for (const [a, b] of n.ranges?.length ? n.ranges : [[n.from ?? MIN_SUBJECT_YEAR, n.to ?? MAX_SUBJECT_YEAR]]) {
+        lo = Math.min(lo, a);
+        hi = Math.max(hi, b);
+      }
+    }
+    const out = [];
+    for (let y = Math.min(hi, MAX_SUBJECT_YEAR); y >= Math.max(lo, MIN_SUBJECT_YEAR); y--) if (declared.every((n) => coversYear(n, y))) out.push({ value: String(y), label: String(y) });
+    return out;
+  }
+  const levels = subjectLevels(kind);
+  const at = levels.findIndex((f) => f.key === fieldKey);
+  if (at < 0) return [];
+  const before = Object.fromEntries(levels.slice(0, at).map((f) => [f.key, values[f.key]]));
+  const { path, next } = walk({ ...kind, fields: kind.fields.filter((f) => levels.slice(0, at).includes(f) || f.type === "year") }, before);
+  if (path.length < at || !next) return [];
+  const year = asYear(values[kind.fields.find((f) => f.type === "year" && f.source === "catalog")?.key ?? ""]);
+  return Object.entries(next).filter(([, n]) => year === null || coversYear(n, year)).map(([value, n]) => ({ value, label: n.label })).sort(byLabel);
+}
+function reconcileSubjectValues(kind, values) {
+  const out = { ...values };
+  for (const f of kind.fields) {
+    if (f.source !== "catalog" || !isPresent(out[f.key])) continue;
+    const options = subjectOptions(kind, f.key, out);
+    const v = String(out[f.key]);
+    const ok = f.type === "year" ? options.length === 0 || options.some((o) => o.value === v) : options.some((o) => o.value === v || o.value === v.toLowerCase());
+    if (!ok) out[f.key] = "";
+  }
+  return out;
+}
+function resolveSubject(kind, values) {
+  const problems = {};
+  const known = new Set(kind.fields.map((f) => f.key));
+  for (const key2 of Object.keys(values)) if (isPresent(values[key2]) && !known.has(key2)) problems[key2] = "unknown";
+  const attributes = {};
+  const priv = {};
+  const display = {};
+  const ids = {};
+  const path = [];
+  let tree = kind.catalog?.tree;
+  const years = [];
+  const put = (f, v) => {
+    if (f.private) priv[f.key] = String(v);
+    else attributes[f.key] = v;
+  };
+  for (const f of kind.fields) {
+    const raw = values[f.key];
+    if (!isPresent(raw)) {
+      if (f.required) problems[f.key] = "required";
+      if (f.source === "catalog" && f.type !== "year") tree = void 0;
+      continue;
+    }
+    const max = f.max ?? MAX_VALUE_LENGTH;
+    if (f.type === "year") {
+      const y = asYear(raw);
+      if (y === null) {
+        problems[f.key] = "invalid";
+        continue;
+      }
+      put(f, y);
+      display[f.key] = ids[f.key] = String(y);
+      if (f.source === "catalog") years.push(f.key);
+    } else if (f.source === "catalog") {
+      if (!kind.catalog) {
+        problems[f.key] = "catalog_unavailable";
+        continue;
+      }
+      const s = cleanText(raw, max);
+      if (s === null) {
+        problems[f.key] = "invalid";
+        continue;
+      }
+      const node = tree?.[s] ?? tree?.[s.toLowerCase()];
+      if (!node) {
+        problems[f.key] = "not_in_catalog";
+        continue;
+      }
+      const id = tree?.[s] ? s : s.toLowerCase();
+      path.push(node);
+      tree = node.children;
+      put(f, id);
+      display[f.key] = node.label;
+      ids[f.key] = id;
+    } else {
+      const s = cleanText(raw, max);
+      if (s === null) {
+        problems[f.key] = "invalid";
+        continue;
+      }
+      put(f, s);
+      display[f.key] = s;
+      ids[f.key] = slug(s);
+    }
+  }
+  for (const key2 of years) {
+    const y = attributes[key2];
+    if (y !== void 0 && !problems[key2] && !path.every((n) => coversYear(n, y))) problems[key2] = "year_range";
+  }
+  if (Object.keys(problems).length > 0) return { ok: false, problems };
+  const label = [...kind.fields.filter((f) => !f.private).map((f) => display[f.key]).filter(Boolean).join(" ")].slice(0, MAX_LABEL_LENGTH).join("").trim();
+  if (!label) return { ok: false, problems: { _: "required" } };
+  let complete = true;
+  const key = kind.fit_key_template.replace(/\{([a-z][a-z0-9_]*)\}/g, (_m, name) => {
+    const id = ids[name];
+    if (!id) complete = false;
+    return id ?? "";
+  });
+  return { ok: true, subject: { label, fit_key: complete && key.length <= MAX_FIT_KEY_LENGTH ? key.toLowerCase() : "", attributes, private: priv } };
+}
+var PRIVATE_MASK = "\u2022\u2022";
+var isMasked = (v) => typeof v === "string" && v.startsWith(PRIVATE_MASK);
+var DEFAULT_FIT_TAG_PREFIX = "fit:";
+var fitTag = (fitKey, prefix = DEFAULT_FIT_TAG_PREFIX) => `${prefix}${fitKey}`;
+function fitTagsAny(fitKey, opts = {}) {
+  if (!fitKey) return [];
+  const prefix = opts.prefix ?? DEFAULT_FIT_TAG_PREFIX;
+  return opts.universal === false ? [fitTag(fitKey, prefix)] : [fitTag(fitKey, prefix), `${prefix}universal`];
+}
+var SUBJECT_CATALOG_PAGE_BYTES = 28 * 1024;
+var utf8Bytes = (s) => new TextEncoder().encode(s).length;
+function splitSubjectTree(tree, maxBytes = SUBJECT_CATALOG_PAGE_BYTES) {
+  const size = (part) => utf8Bytes(JSON.stringify(JSON.stringify(part)));
+  const parts = [];
+  let current = {};
+  for (const [id, node] of Object.entries(tree)) {
+    if (size({ [id]: node }) > maxBytes) throw new RangeError(`splitSubjectTree: option ${id} alone exceeds ${maxBytes} bytes`);
+    const next = { ...current, [id]: node };
+    if (Object.keys(current).length > 0 && size(next) > maxBytes) {
+      parts.push(current);
+      current = { [id]: node };
+    } else current = next;
+  }
+  if (Object.keys(current).length > 0) parts.push(current);
+  return parts;
+}
+
 // src/delivery.ts
 function parseDelivery(value) {
   const raw = (value ?? "").trim();
@@ -1566,11 +1782,16 @@ function deliveryNotices(delivery) {
 
 exports.CLIENT_IP_HEADER = CLIENT_IP_HEADER;
 exports.COUNTRY_HEADERS = COUNTRY_HEADERS;
+exports.DEFAULT_FIT_TAG_PREFIX = DEFAULT_FIT_TAG_PREFIX;
+exports.MAX_SUBJECT_YEAR = MAX_SUBJECT_YEAR;
+exports.MIN_SUBJECT_YEAR = MIN_SUBJECT_YEAR;
 exports.MISSING_WEIGHT = MISSING_WEIGHT;
 exports.NOTE_MAX_LENGTH = NOTE_MAX_LENGTH;
 exports.PAYMENT_CHOICE_REFUSED_FIELD = PAYMENT_CHOICE_REFUSED_FIELD;
 exports.PICKUP_STEPS = PICKUP_STEPS;
+exports.PRIVATE_MASK = PRIVATE_MASK;
 exports.SHIPPING_STEPS = SHIPPING_STEPS;
+exports.SUBJECT_CATALOG_PAGE_BYTES = SUBJECT_CATALOG_PAGE_BYTES;
 exports.StorefrontError = StorefrontError;
 exports.appendParams = appendParams;
 exports.availabilityLocale = availabilityLocale;
@@ -1579,6 +1800,7 @@ exports.availabilityView = availabilityView;
 exports.cartLineProblemView = cartLineProblemView;
 exports.clampPercent = clampPercent;
 exports.classifyPaymentError = classifyPaymentError;
+exports.coversYear = coversYear;
 exports.createStorefrontClient = createStorefrontClient;
 exports.dataExportBytes = dataExportBytes;
 exports.declineMessage = declineMessage;
@@ -1586,6 +1808,8 @@ exports.declineMessageKey = declineMessageKey;
 exports.deliveryInput = deliveryInput;
 exports.deliveryNotices = deliveryNotices;
 exports.diagnose = diagnose;
+exports.fitTag = fitTag;
+exports.fitTagsAny = fitTagsAny;
 exports.formatAvailabilityMessage = formatAvailabilityMessage;
 exports.formatMoney = formatMoney;
 exports.formatVoucherExpiry = formatVoucherExpiry;
@@ -1594,6 +1818,7 @@ exports.groupInvoiceDocs = groupInvoiceDocs;
 exports.hreflangLinks = hreflangLinks;
 exports.invoiceFileBytes = invoiceFileBytes;
 exports.isAccountDeleteBlocked = isAccountDeleteBlocked;
+exports.isMasked = isMasked;
 exports.isReauthRequired = isReauthRequired;
 exports.isStorefrontError = isStorefrontError;
 exports.isTestInvoice = isTestInvoice;
@@ -1619,8 +1844,10 @@ exports.productAvailability = productAvailability;
 exports.productListQuery = productListQuery;
 exports.promoProgressView = promoProgressView;
 exports.promotionMessages = promotionMessages;
+exports.reconcileSubjectValues = reconcileSubjectValues;
 exports.repairPath = repairPath;
 exports.resolveAvailability = resolveAvailability;
+exports.resolveSubject = resolveSubject;
 exports.rewardLabel = rewardLabel;
 exports.safeExportFilename = safeExportFilename;
 exports.safeHttpsUrl = safeHttpsUrl;
@@ -1629,7 +1856,11 @@ exports.safeTrackingUrl = safeTrackingUrl;
 exports.schemaAvailability = schemaAvailability;
 exports.shipmentsStatus = shipmentsStatus;
 exports.sortTrackingEvents = sortTrackingEvents;
+exports.splitSubjectTree = splitSubjectTree;
 exports.storefrontDomainHeader = storefrontDomainHeader;
+exports.subjectFields = subjectFields;
+exports.subjectLevels = subjectLevels;
+exports.subjectOptions = subjectOptions;
 exports.suggestMarket = suggestMarket;
 exports.toMoney = toMoney;
 exports.visitorCountry = visitorCountry;