@shoppexio/storefront 1.0.107 → 1.0.108

package/dist/index.d.cts

@@ -3,6 +3,7 @@ import { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 export { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 import { StorefrontDeliveryType } from '@shoppex/contracts/storefront-delivery-type';
 import { createApiClient } from '@shoppex/contracts/api-client';
+import { BuyerStatusFilter } from '@shoppex/contracts/buyer-invoice-status';
 import { CustomerWarrantyClaimWire, CustomerPortalAffiliateCreateLinkWire, CustomerPortalDashboardWire, CustomerPortalPaginatedInvoicesWire, CustomerPortalInvoiceDetailWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire, CustomerPortalOrderReviewWire, CustomerPortalNotificationPreferencesWire } from '@shoppex/contracts/customer-account-wire';
 export { CATALOG_UNIT_PRICE_DECIMAL_PLACES, CATALOG_UNIT_PRICE_FORMAT_OPTIONS, PAYABLE_AMOUNT_DECIMAL_PLACES, roundPayableAmount } from '@shoppex/contracts/catalog-unit-price';
 
@@ -541,21 +542,30 @@ interface Subscription {
     interval?: SubscriptionInterval;
     flags?: SubscriptionFlags;
 }
+/**
+ * The public invoice read (`GET /v1/invoices/unique/:id`, InvoiceEnricher).
+ * Its lines arrive as `product`; it carries no `products` or `created_at`.
+ */
 interface Invoice {
     uniqid: string;
-    status: string;
-    total: number;
-    currency: string;
-    gateway?: string;
-    products: InvoiceProduct[];
-    created_at: string;
+    status: string | null;
+    /**
+     * The invoice total in USD (InvoiceEnricher maps `totalUsd` here), a decimal
+     * string such as "15.38". It is not in `currency`.
+     */
+    total: string | number;
+    currency: string | null;
+    gateway: string | null;
+    product: InvoiceProduct[];
     rewards?: BuyerRewards | null;
 }
 interface InvoiceProduct {
-    product_id: string;
+    /** The product's id; null on a line that has no catalog product. */
+    uniqid: string | null;
     title: string;
     quantity: number;
-    price: number;
+    /** The line total in the invoice currency. */
+    total: number;
 }
 type RewardActionType = 'WALLET_CREDIT' | 'COUPON';
 type RewardGrantStatus = 'PENDING' | 'FULFILLED' | 'FAILED' | 'REVOKED';
@@ -594,9 +604,17 @@ interface CouponValidation {
     source?: 'COUPON' | 'AFFILIATE';
     product_restricted?: boolean;
     variant_restricted?: boolean;
-    restriction_scope?: 'all' | 'products' | 'variants' | 'products_and_variants';
+    restriction_scope?: 'all' | 'all_except' | 'products' | 'variants' | 'products_and_variants';
     allowed_product_ids?: string[];
     allowed_variant_ids?: string[];
+    /** 'all_except': every product but these. */
+    excluded_product_ids?: string[];
+    /** Products with a discount of their own on this coupon; a fixed amount is in the shop currency. */
+    product_discounts?: Array<{
+        product_id: string;
+        discount_type: 'percentage' | 'fixed';
+        discount: number;
+    }>;
     message?: string;
 }
 interface CouponValidationOptions {
@@ -1832,6 +1850,11 @@ interface CustomerOrdersQuery {
      * actually chose.
      */
     status?: string;
+    /**
+     * One order-list group of the buyer status table (`@shoppex/contracts/buyer-invoice-status`):
+     * "paid" holds COMPLETED and AWAITING_STOCK, which a single `status` cannot.
+     */
+    statusGroup?: BuyerStatusFilter;
     /** Partial invoice-id search. The producer trims it to 64 characters. */
     search?: string;
 }

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 export { NavigationMenuSlot } from '@shoppex/contracts/navigation';
 import { StorefrontDeliveryType } from '@shoppex/contracts/storefront-delivery-type';
 import { createApiClient } from '@shoppex/contracts/api-client';
+import { BuyerStatusFilter } from '@shoppex/contracts/buyer-invoice-status';
 import { CustomerWarrantyClaimWire, CustomerPortalAffiliateCreateLinkWire, CustomerPortalDashboardWire, CustomerPortalPaginatedInvoicesWire, CustomerPortalInvoiceDetailWire, CustomerLoyaltyWire, CustomerLoyaltyRedeemWire, CustomerWarrantyListWire, CustomerPortalOrderReviewWire, CustomerPortalNotificationPreferencesWire } from '@shoppex/contracts/customer-account-wire';
 export { CATALOG_UNIT_PRICE_DECIMAL_PLACES, CATALOG_UNIT_PRICE_FORMAT_OPTIONS, PAYABLE_AMOUNT_DECIMAL_PLACES, roundPayableAmount } from '@shoppex/contracts/catalog-unit-price';
 
@@ -541,21 +542,30 @@ interface Subscription {
     interval?: SubscriptionInterval;
     flags?: SubscriptionFlags;
 }
+/**
+ * The public invoice read (`GET /v1/invoices/unique/:id`, InvoiceEnricher).
+ * Its lines arrive as `product`; it carries no `products` or `created_at`.
+ */
 interface Invoice {
     uniqid: string;
-    status: string;
-    total: number;
-    currency: string;
-    gateway?: string;
-    products: InvoiceProduct[];
-    created_at: string;
+    status: string | null;
+    /**
+     * The invoice total in USD (InvoiceEnricher maps `totalUsd` here), a decimal
+     * string such as "15.38". It is not in `currency`.
+     */
+    total: string | number;
+    currency: string | null;
+    gateway: string | null;
+    product: InvoiceProduct[];
     rewards?: BuyerRewards | null;
 }
 interface InvoiceProduct {
-    product_id: string;
+    /** The product's id; null on a line that has no catalog product. */
+    uniqid: string | null;
     title: string;
     quantity: number;
-    price: number;
+    /** The line total in the invoice currency. */
+    total: number;
 }
 type RewardActionType = 'WALLET_CREDIT' | 'COUPON';
 type RewardGrantStatus = 'PENDING' | 'FULFILLED' | 'FAILED' | 'REVOKED';
@@ -594,9 +604,17 @@ interface CouponValidation {
     source?: 'COUPON' | 'AFFILIATE';
     product_restricted?: boolean;
     variant_restricted?: boolean;
-    restriction_scope?: 'all' | 'products' | 'variants' | 'products_and_variants';
+    restriction_scope?: 'all' | 'all_except' | 'products' | 'variants' | 'products_and_variants';
     allowed_product_ids?: string[];
     allowed_variant_ids?: string[];
+    /** 'all_except': every product but these. */
+    excluded_product_ids?: string[];
+    /** Products with a discount of their own on this coupon; a fixed amount is in the shop currency. */
+    product_discounts?: Array<{
+        product_id: string;
+        discount_type: 'percentage' | 'fixed';
+        discount: number;
+    }>;
     message?: string;
 }
 interface CouponValidationOptions {
@@ -1832,6 +1850,11 @@ interface CustomerOrdersQuery {
      * actually chose.
      */
     status?: string;
+    /**
+     * One order-list group of the buyer status table (`@shoppex/contracts/buyer-invoice-status`):
+     * "paid" holds COMPLETED and AWAITING_STOCK, which a single `status` cannot.
+     */
+    statusGroup?: BuyerStatusFilter;
     /** Partial invoice-id search. The producer trims it to 64 characters. */
     search?: string;
 }

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   customerWarrantyClaimSchema,
   customerWarrantyListSchema,
   storefrontStorageKey
-} from "./chunk-P7MN6RXP.js";
+} from "./chunk-HMEEWD3P.js";
 
 // ../sdk/src/core/errors.ts
 var CURRENCY_UNAVAILABLE_ERROR_CODE = "errors.storefront.currency_unavailable";
@@ -2686,8 +2686,10 @@ function priceVariantToProductVariant(variant) {
     cloudflareImageId: variant.cloudflareImageId,
     image_url: variant.image_url,
     imageUrl: variant.imageUrl,
+    is_featured: variant.is_featured,
     visibility: variant.visibility,
-    is_private: variant.is_private
+    is_private: variant.is_private,
+    license_period: variant.license_period
   };
 }
 function normalizeProduct(product) {
@@ -4479,6 +4481,7 @@ function orders(options = {}) {
   if (options.page !== void 0) query.set("page", String(options.page));
   if (options.limit !== void 0) query.set("limit", String(options.limit));
   if (options.status) query.set("status", options.status);
+  if (options.statusGroup) query.set("status_group", options.statusGroup);
   if (options.search) query.set("q", options.search);
   const suffix = query.size > 0 ? `?${query.toString()}` : "";
   return requestCustomer(`/invoices${suffix}`, { schema: customerPortalPaginatedInvoicesSchema });