@shoppexio/storefront 1.0.100 → 1.0.102

package/dist/index.d.cts

@@ -271,13 +271,7 @@ interface Product {
     price_display?: string;
     price_discount?: number;
     currency: string;
-    /**
-     * RAW local stock only. `-1` (or any negative value) means unlimited, `0` means
-     * no local units. This is NEVER on its own a purchasable cap: a supplier-backed
-     * product reports `stock: 0` by design and is still buyable. Gate buying on
-     * {@link Product.orderable}, and use `resolveDisplayStock` / `isProductInStock`
-     * rather than reading this field directly.
-     */
+    /** Local stock; a negative value means unlimited. */
     stock?: number;
     /**
      * Per-product override for the shop's stock-counter setting; `null` inherits.
@@ -294,27 +288,8 @@ interface Product {
      */
     hideStockCounter?: boolean | null;
     hide_stock_counter?: boolean | null;
-    /**
-     * Authoritative buyability predicate, mirrored from the backend's order-time
-     * gate: `local stock covers one unit OR an eligible supplier source can fulfil
-     * the line`. This — not `stock` — is what a storefront must gate the buy button,
-     * the quantity cap and the sold-out badge on.
-     *
-     * Absent on payloads that predate Dynamic Delivery. When absent, treat
-     * availability exactly as `stock` alone dictates; a missing field must never
-     * turn a genuinely sold-out product into a buyable one.
-     */
+    /** Whether local stock and visibility allow this selection to be bought. */
     orderable?: boolean;
-    /**
-     * True when an enabled supplier source fulfils this product instead of local
-     * stock. `orderable` remains the buy/sold-out gate; this field decides the
-     * QUANTITY CAP: the supplier purchase — not the local counter — fulfils the line
-     * and the completion excludes it from the local decrement, so residual local
-     * units bound nothing and the cap is unlimited even at `stock: 1`. Absent on
-     * payloads that predate Dynamic Delivery; when absent, the cap stays exactly
-     * what `stock` alone dictates.
-     */
-    supplier_backed?: boolean;
     quantity_min?: number;
     quantity_max?: number;
     min_quantity?: number;
@@ -411,32 +386,10 @@ interface ProductVariant {
     price?: number;
     /** The merchant's SKU for this option; null when they set none. */
     sku?: string | null;
-    /**
-     * RAW local stock for this option only. `-1` (or any negative value) means
-     * unlimited, `0` means no local units — which a supplier-backed option reports
-     * by design. Never render this as a purchasable cap on its own; gate on
-     * {@link ProductVariant.orderable}.
-     */
+    /** Local stock; a negative value means unlimited. */
     stock?: number;
-    /**
-     * Authoritative buyability predicate for this option: `local stock covers one
-     * unit OR an eligible supplier source can fulfil the line`. The backend resolves
-     * a product-wide supplier mapping onto every variant's own flag, so this alone
-     * is authoritative for a selected variant.
-     *
-     * Absent on payloads that predate Dynamic Delivery; when absent, availability
-     * follows `stock` alone, exactly as before.
-     */
+    /** Whether local stock and visibility allow this selection to be bought. */
     orderable?: boolean;
-    /**
-     * True when an enabled supplier source fulfils this option instead of local
-     * stock. `orderable` remains the buy/sold-out gate; this field decides the
-     * QUANTITY CAP — a supplier-backed row is unbounded even when it still holds a
-     * few local units, because the supplier purchase fulfils the line and the
-     * completion excludes it from the local decrement. Absent on payloads that
-     * predate Dynamic Delivery.
-     */
-    supplier_backed?: boolean;
     quantity_min?: number;
     quantity_max?: number;
     quantityMin?: number;
@@ -479,32 +432,10 @@ interface PriceVariant {
     price: number;
     /** The merchant's SKU for this option; null when they set none. */
     sku?: string | null;
-    /**
-     * RAW local stock for this price variant only. `-1` (or any negative value)
-     * means unlimited, `0` means no local units — which a supplier-backed variant
-     * reports by design. Never render this as a purchasable cap on its own; gate on
-     * {@link PriceVariant.orderable}.
-     */
+    /** Local stock; a negative value means unlimited. */
     stock?: number;
-    /**
-     * Authoritative buyability predicate for this price variant: `local stock covers
-     * one unit OR an eligible supplier source can fulfil the line`. The backend
-     * resolves a product-wide supplier mapping onto every variant's own flag, so
-     * this alone is authoritative for a selected variant.
-     *
-     * Absent on payloads that predate Dynamic Delivery; when absent, availability
-     * follows `stock` alone, exactly as before.
-     */
+    /** Whether local stock and visibility allow this selection to be bought. */
     orderable?: boolean;
-    /**
-     * True when an enabled supplier source fulfils this price variant instead of
-     * local stock. `orderable` remains the buy/sold-out gate; this field decides the
-     * QUANTITY CAP — a supplier-backed row is unbounded even when it still holds a
-     * few local units, because the supplier purchase fulfils the line and the
-     * completion excludes it from the local decrement. Absent on payloads that
-     * predate Dynamic Delivery.
-     */
-    supplier_backed?: boolean;
     quantity_min?: number;
     quantity_max?: number;
     quantityMin?: number;
@@ -1698,8 +1629,8 @@ declare function isStorefrontCheckboxCustomFieldValueChecked(value: string | und
 declare function validateStorefrontCustomFieldValue(field: StorefrontCustomField, value: string): string | null;
 declare function buildStorefrontCustomFieldPayload(fields: StorefrontCustomField[], values: Record<string, string>): Record<string, string>;
 
-type VariantLike = Pick<ProductVariant, 'stock' | 'orderable' | 'supplier_backed'> | Pick<PriceVariant, 'stock' | 'orderable' | 'supplier_backed'>;
-type ProductLike = Pick<Product, 'type' | 'stock' | 'orderable' | 'supplier_backed' | 'on_hold' | 'price_variants' | 'variants'> & {
+type VariantLike = Pick<ProductVariant, 'stock' | 'orderable'> | Pick<PriceVariant, 'stock' | 'orderable'>;
+type ProductLike = Pick<Product, 'type' | 'stock' | 'orderable' | 'on_hold' | 'price_variants' | 'variants'> & {
     onHold?: boolean | number | string | null;
     is_on_hold?: boolean | number | string | null;
     isOnHold?: boolean | number | string | null;

package/dist/index.d.ts

@@ -271,13 +271,7 @@ interface Product {
     price_display?: string;
     price_discount?: number;
     currency: string;
-    /**
-     * RAW local stock only. `-1` (or any negative value) means unlimited, `0` means
-     * no local units. This is NEVER on its own a purchasable cap: a supplier-backed
-     * product reports `stock: 0` by design and is still buyable. Gate buying on
-     * {@link Product.orderable}, and use `resolveDisplayStock` / `isProductInStock`
-     * rather than reading this field directly.
-     */
+    /** Local stock; a negative value means unlimited. */
     stock?: number;
     /**
      * Per-product override for the shop's stock-counter setting; `null` inherits.
@@ -294,27 +288,8 @@ interface Product {
      */
     hideStockCounter?: boolean | null;
     hide_stock_counter?: boolean | null;
-    /**
-     * Authoritative buyability predicate, mirrored from the backend's order-time
-     * gate: `local stock covers one unit OR an eligible supplier source can fulfil
-     * the line`. This — not `stock` — is what a storefront must gate the buy button,
-     * the quantity cap and the sold-out badge on.
-     *
-     * Absent on payloads that predate Dynamic Delivery. When absent, treat
-     * availability exactly as `stock` alone dictates; a missing field must never
-     * turn a genuinely sold-out product into a buyable one.
-     */
+    /** Whether local stock and visibility allow this selection to be bought. */
     orderable?: boolean;
-    /**
-     * True when an enabled supplier source fulfils this product instead of local
-     * stock. `orderable` remains the buy/sold-out gate; this field decides the
-     * QUANTITY CAP: the supplier purchase — not the local counter — fulfils the line
-     * and the completion excludes it from the local decrement, so residual local
-     * units bound nothing and the cap is unlimited even at `stock: 1`. Absent on
-     * payloads that predate Dynamic Delivery; when absent, the cap stays exactly
-     * what `stock` alone dictates.
-     */
-    supplier_backed?: boolean;
     quantity_min?: number;
     quantity_max?: number;
     min_quantity?: number;
@@ -411,32 +386,10 @@ interface ProductVariant {
     price?: number;
     /** The merchant's SKU for this option; null when they set none. */
     sku?: string | null;
-    /**
-     * RAW local stock for this option only. `-1` (or any negative value) means
-     * unlimited, `0` means no local units — which a supplier-backed option reports
-     * by design. Never render this as a purchasable cap on its own; gate on
-     * {@link ProductVariant.orderable}.
-     */
+    /** Local stock; a negative value means unlimited. */
     stock?: number;
-    /**
-     * Authoritative buyability predicate for this option: `local stock covers one
-     * unit OR an eligible supplier source can fulfil the line`. The backend resolves
-     * a product-wide supplier mapping onto every variant's own flag, so this alone
-     * is authoritative for a selected variant.
-     *
-     * Absent on payloads that predate Dynamic Delivery; when absent, availability
-     * follows `stock` alone, exactly as before.
-     */
+    /** Whether local stock and visibility allow this selection to be bought. */
     orderable?: boolean;
-    /**
-     * True when an enabled supplier source fulfils this option instead of local
-     * stock. `orderable` remains the buy/sold-out gate; this field decides the
-     * QUANTITY CAP — a supplier-backed row is unbounded even when it still holds a
-     * few local units, because the supplier purchase fulfils the line and the
-     * completion excludes it from the local decrement. Absent on payloads that
-     * predate Dynamic Delivery.
-     */
-    supplier_backed?: boolean;
     quantity_min?: number;
     quantity_max?: number;
     quantityMin?: number;
@@ -479,32 +432,10 @@ interface PriceVariant {
     price: number;
     /** The merchant's SKU for this option; null when they set none. */
     sku?: string | null;
-    /**
-     * RAW local stock for this price variant only. `-1` (or any negative value)
-     * means unlimited, `0` means no local units — which a supplier-backed variant
-     * reports by design. Never render this as a purchasable cap on its own; gate on
-     * {@link PriceVariant.orderable}.
-     */
+    /** Local stock; a negative value means unlimited. */
     stock?: number;
-    /**
-     * Authoritative buyability predicate for this price variant: `local stock covers
-     * one unit OR an eligible supplier source can fulfil the line`. The backend
-     * resolves a product-wide supplier mapping onto every variant's own flag, so
-     * this alone is authoritative for a selected variant.
-     *
-     * Absent on payloads that predate Dynamic Delivery; when absent, availability
-     * follows `stock` alone, exactly as before.
-     */
+    /** Whether local stock and visibility allow this selection to be bought. */
     orderable?: boolean;
-    /**
-     * True when an enabled supplier source fulfils this price variant instead of
-     * local stock. `orderable` remains the buy/sold-out gate; this field decides the
-     * QUANTITY CAP — a supplier-backed row is unbounded even when it still holds a
-     * few local units, because the supplier purchase fulfils the line and the
-     * completion excludes it from the local decrement. Absent on payloads that
-     * predate Dynamic Delivery.
-     */
-    supplier_backed?: boolean;
     quantity_min?: number;
     quantity_max?: number;
     quantityMin?: number;
@@ -1698,8 +1629,8 @@ declare function isStorefrontCheckboxCustomFieldValueChecked(value: string | und
 declare function validateStorefrontCustomFieldValue(field: StorefrontCustomField, value: string): string | null;
 declare function buildStorefrontCustomFieldPayload(fields: StorefrontCustomField[], values: Record<string, string>): Record<string, string>;
 
-type VariantLike = Pick<ProductVariant, 'stock' | 'orderable' | 'supplier_backed'> | Pick<PriceVariant, 'stock' | 'orderable' | 'supplier_backed'>;
-type ProductLike = Pick<Product, 'type' | 'stock' | 'orderable' | 'supplier_backed' | 'on_hold' | 'price_variants' | 'variants'> & {
+type VariantLike = Pick<ProductVariant, 'stock' | 'orderable'> | Pick<PriceVariant, 'stock' | 'orderable'>;
+type ProductLike = Pick<Product, 'type' | 'stock' | 'orderable' | 'on_hold' | 'price_variants' | 'variants'> & {
     onHold?: boolean | number | string | null;
     is_on_hold?: boolean | number | string | null;
     isOnHold?: boolean | number | string | null;

package/dist/index.js

@@ -2472,12 +2472,7 @@ function priceVariantToProductVariant(variant) {
     price: typeof variant.price === "number" ? variant.price : Number(variant.price) || 0,
     sku: variant.sku,
     stock: typeof variant.stock === "number" ? variant.stock : void 0,
-    // Dynamic Delivery (S8): carry the availability pair through. A supplier-backed
-    // variant reports `stock: 0`, so dropping `orderable` here would make the mapped
-    // variant look sold out. Left `undefined` when the source omits it, which keeps
-    // the historical stock-only behaviour for payloads that predate the field.
     orderable: typeof variant.orderable === "boolean" ? variant.orderable : void 0,
-    supplier_backed: typeof variant.supplier_backed === "boolean" ? variant.supplier_backed : void 0,
     quantity_min: variant.quantity_min,
     quantity_max: variant.quantity_max,
     quantityMin: variant.quantityMin,
@@ -2668,6 +2663,16 @@ function isSafeHttpsRedirectTemplateUrl(url) {
   }
 }
 
+// ../contracts/src/storefront-consent-choice.ts
+var COOKIE_CONSENT_VERSION = 1;
+var COOKIE_CONSENT_COOKIE = "shoppex_consent";
+var COOKIE_CONSENT_CHECKOUT_HASH_KEY = "shoppex_consent";
+var COOKIE_CONSENT_VALUE = new RegExp(`^v${COOKIE_CONSENT_VERSION}\\.f([01])\\.a([01])\\.m([01])$`);
+function parseCookieConsentValue(value) {
+  const match = value ? COOKIE_CONSENT_VALUE.exec(value) : null;
+  return match ? { functional: match[1] === "1", analytics: match[2] === "1", marketing: match[3] === "1" } : null;
+}
+
 // ../sdk/src/modules/checkout.ts
 var CheckoutCreateError = class _CheckoutCreateError extends Error {
   constructor(message, options = {}) {
@@ -2832,10 +2837,16 @@ function buildCheckoutUrlFromInvoiceId(checkoutBaseUrl, invoiceId) {
     return null;
   }
 }
+function readStorefrontConsentValue() {
+  if (typeof document === "undefined" || typeof document.cookie !== "string") return null;
+  const value = document.cookie.split(";").map((part) => part.trim()).find((part) => part.startsWith(`${COOKIE_CONSENT_COOKIE}=`))?.slice(COOKIE_CONSENT_COOKIE.length + 1);
+  return parseCookieConsentValue(value) ? value : null;
+}
 function appendCheckoutUrlOptions(checkoutUrl, options) {
   const normalizedEmail = normalizeEmail(options.email);
   const normalizedLocale = typeof options.locale === "string" ? options.locale.trim() : "";
-  if (!normalizedEmail && !normalizedLocale) {
+  const consent = readStorefrontConsentValue();
+  if (!normalizedEmail && !normalizedLocale && !consent) {
     return checkoutUrl;
   }
   try {
@@ -2843,9 +2854,10 @@ function appendCheckoutUrlOptions(checkoutUrl, options) {
     if (normalizedLocale) {
       parsedCheckoutUrl.searchParams.set("locale", normalizedLocale);
     }
-    if (normalizedEmail) {
+    if (normalizedEmail || consent) {
       const hashParams = new URLSearchParams(parsedCheckoutUrl.hash.startsWith("#") ? parsedCheckoutUrl.hash.slice(1) : parsedCheckoutUrl.hash);
-      hashParams.set(CHECKOUT_PREFILL_EMAIL_HASH_KEY, normalizedEmail);
+      if (normalizedEmail) hashParams.set(CHECKOUT_PREFILL_EMAIL_HASH_KEY, normalizedEmail);
+      if (consent) hashParams.set(COOKIE_CONSENT_CHECKOUT_HASH_KEY, consent);
       parsedCheckoutUrl.hash = hashParams.toString();
     }
     return parsedCheckoutUrl.toString();
@@ -3303,18 +3315,6 @@ async function getShopReviews() {
 
 // ../sdk/src/utils/storefront-stock.ts
 var UNLIMITED_STOCK = -1;
-function applyOrderable(stock, orderable, supplierBacked) {
-  if (orderable !== true) {
-    return stock;
-  }
-  if (supplierBacked === true) {
-    return UNLIMITED_STOCK;
-  }
-  if (stock !== 0) {
-    return stock;
-  }
-  return UNLIMITED_STOCK;
-}
 function normalizeStockValue(value) {
   if (typeof value !== "number" || !Number.isFinite(value)) {
     return null;
@@ -3344,18 +3344,14 @@ function collectVariantStocks(product) {
 }
 function resolveVariantStockValue(variant) {
   const normalized = normalizeStockValue(variant?.stock);
-  return applyOrderable(normalized ?? UNLIMITED_STOCK, variant?.orderable, variant?.supplier_backed);
+  return normalized ?? UNLIMITED_STOCK;
 }
 function resolveDisplayStock(product) {
   if (!product) {
     return UNLIMITED_STOCK;
   }
   if (typeof product.type === "string" && product.type.toUpperCase() === "SERIALS") {
-    return applyOrderable(
-      normalizeStockValue(product.stock) ?? UNLIMITED_STOCK,
-      product.orderable,
-      product.supplier_backed
-    );
+    return normalizeStockValue(product.stock) ?? UNLIMITED_STOCK;
   }
   const variantStocks = collectVariantStocks(product);
   if (variantStocks.length > 0) {
@@ -3363,13 +3359,9 @@ function resolveDisplayStock(product) {
       return UNLIMITED_STOCK;
     }
     const total = variantStocks.reduce((sum, stock) => sum + Math.max(stock, 0), 0);
-    return applyOrderable(total, product.orderable, product.supplier_backed);
+    return total;
   }
-  return applyOrderable(
-    normalizeStockValue(product.stock) ?? UNLIMITED_STOCK,
-    product.orderable,
-    product.supplier_backed
-  );
+  return normalizeStockValue(product.stock) ?? UNLIMITED_STOCK;
 }
 function isProductOutOfStock(product) {
   if (isProductOnHold(product)) return true;