@asteby/storefront 0.17.0 → 0.18.0

package/dist/mock.d.cts

@@ -1,4 +1,4 @@
-import { a6 as IdentityRulesV1, bg as RegionFiscalId, a4 as IdentityDocumentSpec, be as Region, bx as Shop, a$ as Product, y as Collection, bG as Theme, aG as Page, ap as Menu, c as Article, C as Cart, a as Address, af as InvoiceRequest, B as Customer, $ as FiscalProfile, aw as Order, aJ as PaymentAttemptResult, aY as PendingPayment, ah as InvoiceStage, D as CustomerCapabilities, b6 as PromotionAnnouncement, bw as ShippingRate, aQ as PaymentMethod } from './account-settings-H6zuI7iG.cjs';
+import { bM as SubjectKind, a6 as IdentityRulesV1, bg as RegionFiscalId, a4 as IdentityDocumentSpec, be as Region, bx as Shop, a$ as Product, y as Collection, bP as Theme, aG as Page, ap as Menu, c as Article, C as Cart, a as Address, af as InvoiceRequest, B as Customer, $ as FiscalProfile, bG as Subject, aw as Order, aJ as PaymentAttemptResult, aY as PendingPayment, ah as InvoiceStage, D as CustomerCapabilities, b6 as PromotionAnnouncement, bw as ShippingRate, aQ as PaymentMethod } from './account-settings-DAzmXHIn.cjs';
 import './geo.cjs';
 
 /**
@@ -16,6 +16,8 @@ declare const MOCK_POSTAL_CENTROIDS: Record<string, {
     lng: number;
 }>;
 
+declare const MOCK_SUBJECT_KINDS: SubjectKind[];
+
 /**
  * Region fixture of the mock: Mexico exactly as `GET /storefront/region` publishes it (see `region-mx.seed.ts`),
  * identity document `MX:csf` included, so a storefront can be built and tested without a server. It lives here,
@@ -89,6 +91,11 @@ type MockStorefrontOptions = {
      * carriers, ETAs and quote deadlines). `expires_at` missing: 24 h from the request. Free shipping still applies.
      */
     shippingRates?: ShippingRate[];
+    /**
+     * `fixed_when_free`: past `policies.free_shipping_min` `delivery-options` serves ONLY the shop's free rate and flags
+     * `free` / `fixed` (what the `storefront_cart` addon does with the setting of the same name). Default: the usual list.
+     */
+    shippingQuoteMode?: 'carriers' | 'fixed_when_free';
     /** Methods served by `payment-methods` (default one builtin `mock`). */
     paymentMethods?: PaymentMethod[];
     /**
@@ -96,6 +103,11 @@ type MockStorefrontOptions = {
      * organization has no region, the route answers `404` and invoice requests are not validated against a region.
      */
     region?: Region | null;
+    /**
+     * The kinds of buyer item («My items») the store declares, served by `GET /subject-kinds` and enforced by
+     * `customer.subjects`. Default none: no such section, as in a store that declares nothing (`MOCK_SUBJECT_KINDS` has two).
+     */
+    subjectKinds?: SubjectKind[];
 };
 type CartRecord = {
     id: string;
@@ -128,6 +140,10 @@ type MockState = {
     addresses: Map<string, Address[]>;
     /** Saved fiscal profiles by customer id (contract 1.9). */
     fiscalProfiles: Map<string, FiscalProfile[]>;
+    /** Saved items by customer id (contract 1.9); `private` holds the values the API only returns masked. */
+    subjects: Map<string, (Subject & {
+        private: Record<string, string>;
+    })[]>;
     orders: (Order & {
         customer_id: string | null;
     })[];
@@ -191,4 +207,4 @@ declare function createMockStorefront(options?: MockStorefrontOptions): {
 };
 type MockStorefront = ReturnType<typeof createMockStorefront>;
 
-export { MOCK_CSF_RULES, MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_FISCAL_ID_MX, MOCK_IDENTITY_DOCUMENT_MX_CSF, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, MOCK_REGION_MX, type MockImageUrl, type MockState, type MockStorefront, type MockStorefrontOptions, createMockStorefront };
+export { MOCK_CSF_RULES, MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_FISCAL_ID_MX, MOCK_IDENTITY_DOCUMENT_MX_CSF, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, MOCK_REGION_MX, MOCK_SUBJECT_KINDS, type MockImageUrl, type MockState, type MockStorefront, type MockStorefrontOptions, createMockStorefront };

package/dist/mock.d.ts

@@ -1,4 +1,4 @@
-import { a6 as IdentityRulesV1, bg as RegionFiscalId, a4 as IdentityDocumentSpec, be as Region, bx as Shop, a$ as Product, y as Collection, bG as Theme, aG as Page, ap as Menu, c as Article, C as Cart, a as Address, af as InvoiceRequest, B as Customer, $ as FiscalProfile, aw as Order, aJ as PaymentAttemptResult, aY as PendingPayment, ah as InvoiceStage, D as CustomerCapabilities, b6 as PromotionAnnouncement, bw as ShippingRate, aQ as PaymentMethod } from './account-settings-DNcJKOQl.js';
+import { bM as SubjectKind, a6 as IdentityRulesV1, bg as RegionFiscalId, a4 as IdentityDocumentSpec, be as Region, bx as Shop, a$ as Product, y as Collection, bP as Theme, aG as Page, ap as Menu, c as Article, C as Cart, a as Address, af as InvoiceRequest, B as Customer, $ as FiscalProfile, bG as Subject, aw as Order, aJ as PaymentAttemptResult, aY as PendingPayment, ah as InvoiceStage, D as CustomerCapabilities, b6 as PromotionAnnouncement, bw as ShippingRate, aQ as PaymentMethod } from './account-settings-Cw3PamUA.js';
 import './geo.js';
 
 /**
@@ -16,6 +16,8 @@ declare const MOCK_POSTAL_CENTROIDS: Record<string, {
     lng: number;
 }>;
 
+declare const MOCK_SUBJECT_KINDS: SubjectKind[];
+
 /**
  * Region fixture of the mock: Mexico exactly as `GET /storefront/region` publishes it (see `region-mx.seed.ts`),
  * identity document `MX:csf` included, so a storefront can be built and tested without a server. It lives here,
@@ -89,6 +91,11 @@ type MockStorefrontOptions = {
      * carriers, ETAs and quote deadlines). `expires_at` missing: 24 h from the request. Free shipping still applies.
      */
     shippingRates?: ShippingRate[];
+    /**
+     * `fixed_when_free`: past `policies.free_shipping_min` `delivery-options` serves ONLY the shop's free rate and flags
+     * `free` / `fixed` (what the `storefront_cart` addon does with the setting of the same name). Default: the usual list.
+     */
+    shippingQuoteMode?: 'carriers' | 'fixed_when_free';
     /** Methods served by `payment-methods` (default one builtin `mock`). */
     paymentMethods?: PaymentMethod[];
     /**
@@ -96,6 +103,11 @@ type MockStorefrontOptions = {
      * organization has no region, the route answers `404` and invoice requests are not validated against a region.
      */
     region?: Region | null;
+    /**
+     * The kinds of buyer item («My items») the store declares, served by `GET /subject-kinds` and enforced by
+     * `customer.subjects`. Default none: no such section, as in a store that declares nothing (`MOCK_SUBJECT_KINDS` has two).
+     */
+    subjectKinds?: SubjectKind[];
 };
 type CartRecord = {
     id: string;
@@ -128,6 +140,10 @@ type MockState = {
     addresses: Map<string, Address[]>;
     /** Saved fiscal profiles by customer id (contract 1.9). */
     fiscalProfiles: Map<string, FiscalProfile[]>;
+    /** Saved items by customer id (contract 1.9); `private` holds the values the API only returns masked. */
+    subjects: Map<string, (Subject & {
+        private: Record<string, string>;
+    })[]>;
     orders: (Order & {
         customer_id: string | null;
     })[];
@@ -191,4 +207,4 @@ declare function createMockStorefront(options?: MockStorefrontOptions): {
 };
 type MockStorefront = ReturnType<typeof createMockStorefront>;
 
-export { MOCK_CSF_RULES, MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_FISCAL_ID_MX, MOCK_IDENTITY_DOCUMENT_MX_CSF, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, MOCK_REGION_MX, type MockImageUrl, type MockState, type MockStorefront, type MockStorefrontOptions, createMockStorefront };
+export { MOCK_CSF_RULES, MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_FISCAL_ID_MX, MOCK_IDENTITY_DOCUMENT_MX_CSF, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, MOCK_REGION_MX, MOCK_SUBJECT_KINDS, type MockImageUrl, type MockState, type MockStorefront, type MockStorefrontOptions, createMockStorefront };

package/dist/mock.js

@@ -1,4 +1,4 @@
-import { resolveAvailability, isTestShipment, sortTrackingEvents, orderProgress, nextAction, orderShipments, shipmentsStatus } from './chunk-IPUAZ3LQ.js';
+import { resolveAvailability, isMasked, isTestShipment, sortTrackingEvents, orderProgress, nextAction, orderShipments, shipmentsStatus, PRIVATE_MASK, resolveSubject } from './chunk-5BJRZIS3.js';
 import { isValidPoint, rankByDistance } from './chunk-45R47HYO.js';
 
 // src/mock/account-seed.ts
@@ -1511,6 +1511,55 @@ function buildCustomers() {
   ];
 }
 
+// src/mock/subjects.ts
+var MOCK_SUBJECT_KINDS = [
+  {
+    key: "vehicle",
+    label: "Veh\xEDculo",
+    label_plural: "Mi garage",
+    max_per_account: 3,
+    attach_to_order: true,
+    fit_key_template: "{make}/{model}/{year}/{engine}",
+    fields: [
+      { key: "make", label: "Marca", type: "select", source: "catalog", required: true },
+      { key: "model", label: "Modelo", type: "select", source: "catalog", depends_on: "make", required: true },
+      { key: "year", label: "A\xF1o", type: "year", source: "catalog", depends_on: "model", required: true },
+      { key: "engine", label: "Versi\xF3n / motor", type: "select", source: "catalog", depends_on: "year" },
+      { key: "plate", label: "Placas (opcional)", type: "text", max: 12, private: true }
+    ],
+    catalog: {
+      version: "mock-1",
+      tree: {
+        nissan: {
+          label: "Nissan",
+          children: {
+            np300: {
+              label: "NP300 Frontier",
+              from: 2008,
+              to: 2022,
+              children: { "2.5": { label: "2.5 L", ranges: [[2010, 2015]] }, "2.4": { label: "2.4 L" } }
+            },
+            versa: { label: "Versa", from: 2012, to: 2024, children: { "1.6": { label: "1.6 L" } } }
+          }
+        },
+        ford: { label: "Ford", children: { f150: { label: "F-150", from: 2e3, to: 2020, children: { "5.0": { label: "5.0 L" } } } } }
+      }
+    }
+  },
+  {
+    key: "size",
+    label: "Talla",
+    label_plural: "Mis tallas",
+    max_per_account: 5,
+    fit_key_template: "{garment}/{value}",
+    fields: [
+      { key: "garment", label: "Prenda", type: "text", required: true },
+      { key: "value", label: "Talla", type: "text", required: true, max: 8 }
+    ],
+    catalog: null
+  }
+];
+
 // src/mock/index.ts
 var HttpError = class extends Error {
   constructor(status, code, message, field, details, requiredScopes) {
@@ -1588,6 +1637,7 @@ function createMockStorefront(options = {}) {
     notifications: { channels: ["email"] },
     data_export: true,
     account_delete: true,
+    ...(options.subjectKinds?.length ?? 0) > 0 ? { subjects: { kinds: options.subjectKinds.map((k) => k.key), share_with_workshop: false } } : {},
     ...options.customerCapabilities
   };
   const missingScopes = options.missingScopes ?? [];
@@ -1619,6 +1669,7 @@ function createMockStorefront(options = {}) {
       customers: buildCustomers(),
       addresses: /* @__PURE__ */ new Map(),
       fiscalProfiles: /* @__PURE__ */ new Map(),
+      subjects: /* @__PURE__ */ new Map(),
       orders: [
         {
           id: "ord_seed_1",
@@ -1724,6 +1775,9 @@ function createMockStorefront(options = {}) {
       if (list.length > 100) throw new HttpError(400, "validation", "At most 100 handles", "handles");
       items = items.filter((p) => list.includes(p.handle));
     }
+    const tagsAny = (search.get("tags_any") ?? "").split(",").map((t) => t.trim().toLowerCase()).filter(Boolean);
+    if (tagsAny.length > 5 || tagsAny.some((t) => t.length > 120)) throw new HttpError(400, "validation", "tags_any takes at most 5 tags of 120 characters", "tags_any");
+    if (tagsAny.length > 0) items = items.filter((p) => p.tags.some((t) => tagsAny.includes(t.toLowerCase())));
     const base = items;
     if (search.get("available") === "true") items = items.filter((p) => p.available_for_sale);
     const priceMin = search.get("price_min");
@@ -1851,6 +1905,7 @@ function createMockStorefront(options = {}) {
       const expires = new Date(Date.now() + 24 * 36e5).toISOString();
       return options.shippingRates.map((r) => ({ ...r, expires_at: r.expires_at ?? expires, cost: free ? fromCents(0, r.cost.currency_code) : r.cost }));
     }
+    if (free && options.shippingQuoteMode === "fixed_when_free") return [{ id: "flat", title: "Env\xEDo gratis", cost: fromCents(0, currency), eta: "2 a 5 d\xEDas h\xE1biles" }];
     return [
       { id: "flat", title: free ? "Env\xEDo est\xE1ndar (gratis)" : "Env\xEDo est\xE1ndar", cost: fromCents(free ? 0 : flatShippingCents, currency), eta: "2 a 5 d\xEDas h\xE1biles" },
       { id: "express", title: "Env\xEDo expr\xE9s", cost: fromCents(flatShippingCents + 1e4, currency), eta: "1 a 2 d\xEDas h\xE1biles" }
@@ -2154,8 +2209,10 @@ function createMockStorefront(options = {}) {
   route("GET", "/carts/:id/delivery-options", "cart:write", ({ params }) => {
     const cart = renderCart(getCartRecord(params[0]));
     const net = toCents(cart.cost.subtotal.amount) - toCents(cart.cost.discount.amount);
+    const rates = shippingRates(net);
+    const free = options.shippingQuoteMode === "fixed_when_free" && rates.length > 0 && rates.every((r) => toCents(r.cost.amount) === 0);
     return {
-      body: { rates: shippingRates(net), pickup: state.shop.branches.filter((b) => b.pickup?.enabled !== false).map((b) => ({ branch_id: b.id, name: b.name, address: b.address, city: b.city })), partial: false, unavailable: [] },
+      body: { rates, free, fixed: free, pickup: state.shop.branches.filter((b) => b.pickup?.enabled !== false).map((b) => ({ branch_id: b.id, name: b.name, address: b.address, city: b.city })), partial: false, unavailable: [] },
       cache: "private"
     };
   });
@@ -2830,6 +2887,89 @@ function createMockStorefront(options = {}) {
     mirrorDefaultProfile(c);
     return { status: 204 };
   });
+  const MAX_SUBJECTS = 50;
+  const subjectsOf = (c) => state.subjects.get(c.id) ?? [];
+  const kinds = () => options.subjectKinds ?? [];
+  const publicSubject = (s) => {
+    const { private: priv, ...rest } = s;
+    return { ...rest, attributes: { ...s.attributes, ...Object.fromEntries(Object.keys(priv).map((k) => [k, PRIVATE_MASK + (priv[k].length > 3 ? priv[k].slice(-2) : "")])) } };
+  };
+  const ownSubject = (c, id) => {
+    const s = subjectsOf(c).find((x) => x.id === id);
+    if (!s) throw new HttpError(404, "not_found", "Item not found", "id");
+    return s;
+  };
+  const setDefaultSubject = (c, id) => {
+    const kind = ownSubject(c, id).kind;
+    state.subjects.set(c.id, subjectsOf(c).map((s) => s.kind !== kind ? s : s.id === id ? { ...s, is_default: true, last_used_at: now() } : { ...s, is_default: false }));
+  };
+  const resolveOrThrow = (kind, values) => {
+    const r = resolveSubject(kind, values);
+    if (!r.ok) {
+      const [field, code] = Object.entries(r.problems)[0];
+      throw new HttpError(422, "validation", `${field}: ${code}`, field === "_" ? "attributes" : `attributes.${field}`);
+    }
+    return r.subject;
+  };
+  const cleanNickname = (v) => {
+    if (v === void 0 || v === null || v === "") return null;
+    if (typeof v !== "string" || [...v.trim()].length > 40) throw new HttpError(422, "validation", "nickname is too long (max 40)", "nickname");
+    return v.trim().split(/\s+/).join(" ");
+  };
+  route("GET", "/subject-kinds", "content:read", () => ({ body: { nodes: kinds() }, cache: "public" }));
+  route("GET", "/customer/subjects", "customer:read", ({ headers, search }) => {
+    const c = requireCustomer(headers);
+    const kind = search.get("kind");
+    const nodes = subjectsOf(c).filter((s) => !kind || s.kind === kind).sort((a, b) => a.kind.localeCompare(b.kind) || Number(b.is_default) - Number(a.is_default) || (b.last_used_at ?? "").localeCompare(a.last_used_at ?? ""));
+    return { body: { nodes: nodes.map(publicSubject) }, cache: "private" };
+  });
+  route("POST", "/customer/subjects", "customer:write", ({ headers, body }) => {
+    const c = requireCustomer(headers);
+    const kind = kinds().find((k) => k.key === body.kind);
+    if (!kind) throw new HttpError(422, "validation", "This store has no such kind", "kind");
+    const attrs = body.attributes;
+    if (!attrs || typeof attrs !== "object" || Array.isArray(attrs)) throw new HttpError(422, "validation", "attributes must be an object", "attributes");
+    const r = resolveOrThrow(kind, attrs);
+    const list = subjectsOf(c);
+    if (list.length >= MAX_SUBJECTS || list.filter((s) => s.kind === kind.key).length >= kind.max_per_account) throw new HttpError(409, "conflict", "Limit reached; delete one first", "kind");
+    if (r.fit_key && list.some((s) => s.kind === kind.key && s.fit_key === r.fit_key)) throw new HttpError(409, "conflict", "You already saved this item", "attributes");
+    const subject = { id: nextId("subj"), kind: kind.key, label: r.label, nickname: cleanNickname(body.nickname), fit_key: r.fit_key, attributes: r.attributes, private: r.private, is_default: false, last_used_at: null, created_at: now() };
+    state.subjects.set(c.id, [...list, subject]);
+    if (!list.some((s) => s.kind === kind.key) || body.is_default === true) setDefaultSubject(c, subject.id);
+    return { status: 201, body: publicSubject(ownSubject(c, subject.id)), cache: "private" };
+  });
+  route("PATCH", "/customer/subjects/:id", "customer:write", ({ headers, params, body }) => {
+    const c = requireCustomer(headers);
+    const cur = ownSubject(c, params[0]);
+    if (body.is_default === false && cur.is_default) throw new HttpError(422, "validation", "Make another item the default instead", "is_default");
+    let next = { ...cur };
+    if ("nickname" in body) next.nickname = cleanNickname(body.nickname);
+    if ("attributes" in body) {
+      const kind = kinds().find((k) => k.key === cur.kind);
+      if (!kind) throw new HttpError(422, "validation", "This store no longer offers this kind", "kind");
+      const sent = body.attributes ?? {};
+      const merged = { ...cur.attributes, ...cur.private };
+      for (const [k, v] of Object.entries(sent)) {
+        if (k in cur.private && isMasked(v)) continue;
+        if (v === null) delete merged[k];
+        else merged[k] = v;
+      }
+      const r = resolveOrThrow(kind, merged);
+      if (r.fit_key && subjectsOf(c).some((s) => s.id !== cur.id && s.kind === cur.kind && s.fit_key === r.fit_key)) throw new HttpError(409, "conflict", "You already saved this item", "attributes");
+      next = { ...next, label: r.label, fit_key: r.fit_key, attributes: r.attributes, private: r.private };
+    }
+    state.subjects.set(c.id, subjectsOf(c).map((s) => s.id === cur.id ? next : s));
+    if (body.is_default === true && !cur.is_default) setDefaultSubject(c, cur.id);
+    return { body: publicSubject(ownSubject(c, cur.id)), cache: "private" };
+  });
+  route("DELETE", "/customer/subjects/:id", "customer:write", ({ headers, params }) => {
+    const c = requireCustomer(headers);
+    const cur = ownSubject(c, params[0]);
+    state.subjects.set(c.id, subjectsOf(c).filter((s) => s.id !== cur.id));
+    const heir = subjectsOf(c).filter((s) => s.kind === cur.kind).sort((a, b) => (b.last_used_at ?? "").localeCompare(a.last_used_at ?? ""))[0];
+    if (cur.is_default && heir) setDefaultSubject(c, heir.id);
+    return { status: 204 };
+  });
   route("GET", "/customer/addresses", "customer:read", ({ headers }) => {
     const c = requireCustomer(headers);
     return { body: { nodes: state.addresses.get(c.id) ?? [] }, cache: "private" };
@@ -2979,6 +3119,6 @@ function createMockStorefront(options = {}) {
   };
 }
 
-export { MOCK_CSF_RULES, MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_FISCAL_ID_MX, MOCK_IDENTITY_DOCUMENT_MX_CSF, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, MOCK_REGION_MX, createMockStorefront };
+export { MOCK_CSF_RULES, MOCK_CURRENCY, MOCK_CUSTOMER_EMAIL, MOCK_FISCAL_ID_MX, MOCK_IDENTITY_DOCUMENT_MX_CSF, MOCK_IMAGE_URL, MOCK_POSTAL_CENTROIDS, MOCK_REGION_MX, MOCK_SUBJECT_KINDS, createMockStorefront };
 //# sourceMappingURL=mock.js.map
 //# sourceMappingURL=mock.js.map