@shoppexio/storefront 1.0.100 → 1.0.101

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,
@@ -3303,18 +3298,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 +3327,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 +3342,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;