@01.software/sdk 0.31.0 → 0.33.0

package/dist/{types-CmLG-7RL.d.cts → types-B3YT092I.d.cts}

@@ -1,4 +1,4 @@
-import { P as Product, C as CustomerProfile, a as CustomerProfileList, b as ProductCollection, c as Post, d as Comment, R as Reaction, e as Config } from './payload-types-Wa4-eC6x.cjs';
+import { P as Product, C as CustomerProfile, a as CustomerProfileList, b as ProductCollection, c as Post, d as Comment, R as Reaction, e as Config } from './payload-types-dkeQyrDC.cjs';
 
 type PublicCustomerProfile = Omit<CustomerProfile, 'tenant' | 'customer' | 'isPublic' | 'anonymizedAt' | 'metadata'>;
 type PublicProfileRelation = string | PublicCustomerProfile;

package/dist/{types-BX2mqDf6.d.ts → types-BHh0YLmq.d.ts}

@@ -1,6 +1,6 @@
-import { P as PublicCollection } from './const-BGCP-OJL.js';
-import { P as PublicProduct, C as CollectionType } from './types-CVA10VC-.js';
-import { O as Order, i as Cart, j as CartItem, m as OrderItem, n as Transaction, o as Fulfillment, p as Return } from './payload-types-Wa4-eC6x.js';
+import { P as PublicCollection } from './const-DwmSDeWq.js';
+import { P as PublicProduct, C as CollectionType } from './types-Cel_4L9t.js';
+import { O as Order, i as Cart, j as CartItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-dkeQyrDC.js';
 
 interface CommunityClientOptions {
     publishableKey?: string;
@@ -504,10 +504,12 @@ type ProductListingSwatch = {
     href: string;
     availableForSale: boolean;
 };
+type ProductListingCardRepresentativeVariant = ProductListingGroupsItem['groups'][number]['variants'][number];
 type ProductListingCard = {
     id: EntityID;
     href: string;
     title: string;
+    representativeVariant?: ProductListingCardRepresentativeVariant | null;
     primaryImage: ProductDetailMedia | null;
     priceRange: ProductListingCardPriceRange;
     availableForSale: boolean;
@@ -666,8 +668,10 @@ type StockCheckParams = {
 };
 type StockCheckResult = {
     variantId: string;
+    status: 'available' | 'not_published' | 'archived' | 'not_found';
     available: boolean;
     availableStock: number;
+    isUnlimited: boolean;
     requestedQuantity: number;
     error?: string;
 };
@@ -678,19 +682,33 @@ type StockCheckResponse = {
 type ListingGroupsParams = {
     productIds: string[];
 };
-type ProductListingGroupSummary = Omit<ProductListingGroup, 'variants'>;
-type ProductListingGroupsProduct = PublicProduct & {
+type ListingGroupingState = 'grouped' | 'no_primary_option' | 'empty';
+type ProductListingGroupVariant = Pick<ProductVariantShape, 'id' | 'optionValues' | 'price' | 'compareAtPrice' | 'stock' | 'isUnlimited' | 'isActive' | 'thumbnail' | 'images' | '_order'>;
+type ProductListingGroupSummary = ProductListingGroup<ProductListingGroupVariant>;
+type ProductListingGroupsProductVariants = NonNullable<PublicProduct['variants']>;
+type ProductListingGroupsProduct = Omit<PublicProduct, 'variants'> & {
     id: string;
     slug: string;
     title: string;
+    variants?: (Omit<ProductListingGroupsProductVariants, 'docs'> & {
+        docs: ProductListingGroupVariant[];
+    }) | null;
 };
 type ProductListingGroupsItem = {
     product: ProductListingGroupsProduct;
     primaryOptionId: string | null;
+    listingGroupingState: ListingGroupingState;
     groups: ProductListingGroupSummary[];
 };
 type ProductListingGroupsResponse = {
+    /**
+     * Matching products in the same order as the requested productIds, excluding
+     * ids that were not found, not published, or not accessible for the current
+     * tenant/key.
+     */
     docs: ProductListingGroupsItem[];
+    /** Requested productIds that could not be returned. */
+    missing: string[];
 };
 type ProductDetailParams = {
     slug: string;
@@ -794,8 +812,9 @@ interface ProductDetail {
         content?: unknown;
         publishedAt?: string | null;
         status: string;
-        totalInventory: number;
+        totalInventory: number | null;
         totalVariants: number;
+        hasUnlimitedVariant: boolean;
         hasOnlyDefaultVariant: boolean;
     };
     variants: ProductDetailVariant[];
@@ -807,6 +826,14 @@ interface ProductDetail {
     videos: ProductDetailVideo[];
     listing: ProductDetailListing;
 }
+type ProductDetailUnavailableReason = 'not_found' | 'not_published' | 'feature_disabled';
+type ProductDetailResult = {
+    found: true;
+    product: ProductDetail;
+} | {
+    found: false;
+    reason: ProductDetailUnavailableReason;
+};
 type ProductUpsertOptionValueInput = {
     id?: string;
     value: string;
@@ -873,11 +900,15 @@ declare class ProductApi extends BaseApi {
     listingGroups(params: ListingGroupsParams): Promise<ProductListingGroupsResponse>;
     /**
      * Fetch full product detail by slug or id.
-     * Returns `null` on 404 regardless of reason (`not_found` / `not_published` /
-     * `tenant_mismatch` / `feature_disabled`). For the reason behind a null,
-     * inspect `client.lastRequestId` against backend logs.
+     * Returns a discriminated result so storefronts can distinguish missing,
+     * unpublished, and feature-disabled products.
+     *
+     * Only product-detail 404 responses carrying one of those allowlisted reasons
+     * are mapped to `{ found: false, reason }`. Unknown or uncoded 404s, plus
+     * permission/auth errors such as tenant mismatch, continue to throw typed SDK
+     * errors instead of being collapsed into a storefront absence result.
      */
-    detail(params: ProductDetailParams): Promise<ProductDetail | null>;
+    detail(params: ProductDetailParams): Promise<ProductDetailResult>;
     /**
      * Atomically create or update a product together with its options,
      * option-values, and variants in a single transaction. Mirrors Shopify's
@@ -936,12 +967,29 @@ type ReturnItem = {
     orderItem: string;
     quantity: number;
 };
+type OrderCreateEntityID = string | number;
+type CreateOrderItem = {
+    product: OrderCreateEntityID;
+    variant: OrderCreateEntityID;
+    option: OrderCreateEntityID;
+    quantity: number;
+    /**
+     * Compatibility input: the create-order endpoint accepts this, but the server
+     * derives authoritative line pricing from the product variant.
+     */
+    unitPrice?: number;
+    /**
+     * Compatibility input: the create-order endpoint accepts this, but the server
+     * derives authoritative line totals from the product variant.
+     */
+    totalPrice?: number;
+};
 type CreateOrderParams = {
     orderNumber: string;
     customer?: string;
     customerSnapshot: CustomerSnapshot;
     shippingAddress: Order['shippingAddress'];
-    orderItems: Pick<OrderItem, 'product' | 'variant' | 'quantity' | 'unitPrice' | 'totalPrice'>[];
+    orderItems: CreateOrderItem[];
     totalAmount: number;
     shippingAmount?: number;
     pgPaymentId?: string;
@@ -986,6 +1034,7 @@ type ReturnWithRefundItem = {
     orderItem: string | number;
     quantity: number;
     restockAction?: RestockAction;
+    restockingFee?: number;
 };
 type ReturnWithRefundParams = {
     orderNumber: string;
@@ -993,6 +1042,7 @@ type ReturnWithRefundParams = {
     reasonDetail?: string;
     returnItems: ReturnWithRefundItem[];
     refundAmount: number;
+    returnShippingFee?: number;
     pgPaymentId: string;
     paymentKey?: string;
     refundReceiptUrl?: string;
@@ -1077,7 +1127,7 @@ declare class CommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
-        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
     };
     readonly cart: {
         get: (cartId: string) => Promise<Cart>;
@@ -1286,4 +1336,4 @@ type DeepPartial<T> = {
 };
 type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-export { type OrderApiOptions as $, type ApiQueryOptions as A, BaseApi as B, CommerceClient as C, type DebugConfig as D, type ExtractArrayType as E, type CreateFulfillmentParams as F, type CreateOrderParams as G, type CreateReturnParams as H, CustomerAuth as I, type CustomerAuthOptions as J, type CustomerAuthResponse as K, type CustomerLoginData as L, type CustomerProfile as M, type CustomerRefreshResponse as N, type CustomerRegisterData as O, type PayloadFindResponse as P, type CustomerRegisterResponse as Q, type RetryConfig as R, type Sort as S, type CustomerSnapshot as T, DiscountApi as U, type DiscountApiOptions as V, type Where as W, type LegacyProductSelectionParamEvent as X, type ListingGroupsParams as Y, type NormalizedProductSelection as Z, OrderApi as _, CommunityClient as a, buildProductHref as a$, ProductApi as a0, type ProductApiOptions as a1, type ProductDetail as a2, type ProductDetailBrand as a3, type ProductDetailCategory as a4, type ProductDetailImage as a5, type ProductDetailImageMedia as a6, type ProductDetailListing as a7, type ProductDetailMedia as a8, type ProductDetailOption as a9, type ProductSelectionByOptionValue as aA, ProductSelectionCodecError as aB, type ProductSelectionCodecOptions as aC, type ProductSelectionInput as aD, type ProductSelectionResolution as aE, type ProductSelectionResolutionContext as aF, type ProductVariantShape as aG, type RemoveDiscountParams as aH, type RemoveItemParams as aI, type RequestOptions as aJ, type ReturnItem as aK, type ReturnReason as aL, type ReturnWithRefundParams as aM, type ServerApiOptions as aN, ShippingApi as aO, type ShippingApiOptions as aP, type StockCheckParams as aQ, type StockCheckResponse as aR, type StockCheckResult as aS, type UpdateFulfillmentParams as aT, type UpdateItemParams as aU, type UpdateOrderParams as aV, type UpdateProfileData as aW, type UpdateReturnParams as aX, type UpdateTransactionParams as aY, type ValidateDiscountParams as aZ, type ValidateDiscountResult as a_, type ProductDetailOptionValue as aa, type ProductDetailParams as ab, type ProductDetailTag as ac, type ProductDetailVariant as ad, type ProductDetailVariantOptionValue as ae, type ProductDetailVideo as af, type ProductHrefGroup as ag, type ProductHrefOptions as ah, type ProductHrefProduct as ai, type ProductListingCard as aj, type ProductListingCardPriceRange as ak, type ProductListingGroup as al, type ProductListingGroupSummary as am, type ProductListingGroupsItem as an, type ProductListingGroupsProduct as ao, type ProductListingGroupsResponse as ap, type ProductListingProductShape as aq, type ProductListingProjection as ar, type ProductListingSwatch as as, type ProductOptionMatrix as at, type ProductOptionMatrixOption as au, type ProductOptionMatrixValue as av, type ProductOptionMatrixVariant as aw, type ProductOptionShape as ax, type ProductOptionValueShape as ay, type ProductSelectionAvailableValue as az, CustomerNamespace as b, buildProductListingCard as b0, buildProductListingGroupsByOption as b1, buildProductListingProjection as b2, buildProductOptionMatrix as b3, buildProductOptionMatrixFromDetail as b4, createProductSelectionCodec as b5, getAvailableOptionValues as b6, getProductSelectionImages as b7, getSelectedValueByOptionId as b8, normalizeProductSelection as b9, normalizeProductSelectionFromMatrix as ba, normalizeSelectedValueIds as bb, parseProductSelection as bc, resolveProductSelection as bd, resolveProductSelectionFromMatrix as be, resolveVariantForSelection as bf, stringifyProductSelection as bg, type ProductDetailPreviewParams as bh, type ProductDetailPreviewOptions as bi, type ProductUpsertParams as bj, type ProductUpsertResponse as bk, type ClientServerConfig as bl, type ClientState as c, type ClientConfig as d, type ClientMetadata as e, type DeepPartial as f, type PayloadMutationResponse as g, type RootClient as h, type RootCollectionClient as i, type RootReadOnlyQueryBuilder as j, type AddItemParams as k, type ApplyDiscountParams as l, type BulkImportFulfillmentsParams as m, type BulkImportFulfillmentsResponse as n, type CalculateShippingParams as o, type CalculateShippingResult as p, CartApi as q, type CartApiOptions as r, type CheckoutParams as s, type ClearCartParams as t, type CommerceClientOptions as u, type CommunityClientOptions as v, type CommunityPost as w, type CompatibilityProductSelectionParamEvent as x, type ConfirmPaymentParams as y, type ConfirmPaymentResponse as z };
+export { type NormalizedProductSelection as $, type ApiQueryOptions as A, BaseApi as B, CommerceClient as C, type DebugConfig as D, type ExtractArrayType as E, type CreateFulfillmentParams as F, type CreateOrderItem as G, type CreateOrderParams as H, type CreateReturnParams as I, CustomerAuth as J, type CustomerAuthOptions as K, type CustomerAuthResponse as L, type CustomerLoginData as M, type CustomerProfile as N, type CustomerRefreshResponse as O, type PayloadFindResponse as P, type CustomerRegisterData as Q, type RetryConfig as R, type Sort as S, type CustomerRegisterResponse as T, type CustomerSnapshot as U, DiscountApi as V, type Where as W, type DiscountApiOptions as X, type LegacyProductSelectionParamEvent as Y, type ListingGroupingState as Z, type ListingGroupsParams as _, CommunityClient as a, type UpdateItemParams as a$, OrderApi as a0, type OrderApiOptions as a1, ProductApi as a2, type ProductApiOptions as a3, type ProductDetail as a4, type ProductDetailBrand as a5, type ProductDetailCategory as a6, type ProductDetailImage as a7, type ProductDetailImageMedia as a8, type ProductDetailListing as a9, type ProductOptionMatrixOption as aA, type ProductOptionMatrixValue as aB, type ProductOptionMatrixVariant as aC, type ProductOptionShape as aD, type ProductOptionValueShape as aE, type ProductSelectionAvailableValue as aF, type ProductSelectionByOptionValue as aG, ProductSelectionCodecError as aH, type ProductSelectionCodecOptions as aI, type ProductSelectionInput as aJ, type ProductSelectionResolution as aK, type ProductSelectionResolutionContext as aL, type ProductVariantShape as aM, type RemoveDiscountParams as aN, type RemoveItemParams as aO, type RequestOptions as aP, type ReturnItem as aQ, type ReturnReason as aR, type ReturnWithRefundItem as aS, type ReturnWithRefundParams as aT, type ServerApiOptions as aU, ShippingApi as aV, type ShippingApiOptions as aW, type StockCheckParams as aX, type StockCheckResponse as aY, type StockCheckResult as aZ, type UpdateFulfillmentParams as a_, type ProductDetailMedia as aa, type ProductDetailOption as ab, type ProductDetailOptionValue as ac, type ProductDetailParams as ad, type ProductDetailResult as ae, type ProductDetailTag as af, type ProductDetailUnavailableReason as ag, type ProductDetailVariant as ah, type ProductDetailVariantOptionValue as ai, type ProductDetailVideo as aj, type ProductHrefGroup as ak, type ProductHrefOptions as al, type ProductHrefProduct as am, type ProductListingCard as an, type ProductListingCardPriceRange as ao, type ProductListingCardRepresentativeVariant as ap, type ProductListingGroup as aq, type ProductListingGroupSummary as ar, type ProductListingGroupVariant as as, type ProductListingGroupsItem as at, type ProductListingGroupsProduct as au, type ProductListingGroupsResponse as av, type ProductListingProductShape as aw, type ProductListingProjection as ax, type ProductListingSwatch as ay, type ProductOptionMatrix as az, CustomerNamespace as b, type UpdateOrderParams as b0, type UpdateProfileData as b1, type UpdateReturnParams as b2, type UpdateTransactionParams as b3, type ValidateDiscountParams as b4, type ValidateDiscountResult as b5, buildProductHref as b6, buildProductListingCard as b7, buildProductListingGroupsByOption as b8, buildProductListingProjection as b9, buildProductOptionMatrix as ba, buildProductOptionMatrixFromDetail as bb, createProductSelectionCodec as bc, getAvailableOptionValues as bd, getProductSelectionImages as be, getSelectedValueByOptionId as bf, normalizeProductSelection as bg, normalizeProductSelectionFromMatrix as bh, normalizeSelectedValueIds as bi, parseProductSelection as bj, resolveProductSelection as bk, resolveProductSelectionFromMatrix as bl, resolveVariantForSelection as bm, stringifyProductSelection as bn, type ProductDetailPreviewParams as bo, type ProductDetailPreviewOptions as bp, type ProductUpsertParams as bq, type ProductUpsertResponse as br, type ClientServerConfig as bs, type ClientState as c, type ClientConfig as d, type ClientMetadata as e, type DeepPartial as f, type PayloadMutationResponse as g, type RootClient as h, type RootCollectionClient as i, type RootReadOnlyQueryBuilder as j, type AddItemParams as k, type ApplyDiscountParams as l, type BulkImportFulfillmentsParams as m, type BulkImportFulfillmentsResponse as n, type CalculateShippingParams as o, type CalculateShippingResult as p, CartApi as q, type CartApiOptions as r, type CheckoutParams as s, type ClearCartParams as t, type CommerceClientOptions as u, type CommunityClientOptions as v, type CommunityPost as w, type CompatibilityProductSelectionParamEvent as x, type ConfirmPaymentParams as y, type ConfirmPaymentResponse as z };

package/dist/{types-DChFjQGz.d.cts → types-BZKxss8Y.d.cts}

@@ -1,6 +1,6 @@
-import { P as PublicCollection } from './const-AytzliEu.cjs';
-import { P as PublicProduct, C as CollectionType } from './types-CmLG-7RL.cjs';
-import { O as Order, i as Cart, j as CartItem, m as OrderItem, n as Transaction, o as Fulfillment, p as Return } from './payload-types-Wa4-eC6x.cjs';
+import { P as PublicCollection } from './const-sPR2IkCe.cjs';
+import { P as PublicProduct, C as CollectionType } from './types-B3YT092I.cjs';
+import { O as Order, i as Cart, j as CartItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-dkeQyrDC.cjs';
 
 interface CommunityClientOptions {
     publishableKey?: string;
@@ -504,10 +504,12 @@ type ProductListingSwatch = {
     href: string;
     availableForSale: boolean;
 };
+type ProductListingCardRepresentativeVariant = ProductListingGroupsItem['groups'][number]['variants'][number];
 type ProductListingCard = {
     id: EntityID;
     href: string;
     title: string;
+    representativeVariant?: ProductListingCardRepresentativeVariant | null;
     primaryImage: ProductDetailMedia | null;
     priceRange: ProductListingCardPriceRange;
     availableForSale: boolean;
@@ -666,8 +668,10 @@ type StockCheckParams = {
 };
 type StockCheckResult = {
     variantId: string;
+    status: 'available' | 'not_published' | 'archived' | 'not_found';
     available: boolean;
     availableStock: number;
+    isUnlimited: boolean;
     requestedQuantity: number;
     error?: string;
 };
@@ -678,19 +682,33 @@ type StockCheckResponse = {
 type ListingGroupsParams = {
     productIds: string[];
 };
-type ProductListingGroupSummary = Omit<ProductListingGroup, 'variants'>;
-type ProductListingGroupsProduct = PublicProduct & {
+type ListingGroupingState = 'grouped' | 'no_primary_option' | 'empty';
+type ProductListingGroupVariant = Pick<ProductVariantShape, 'id' | 'optionValues' | 'price' | 'compareAtPrice' | 'stock' | 'isUnlimited' | 'isActive' | 'thumbnail' | 'images' | '_order'>;
+type ProductListingGroupSummary = ProductListingGroup<ProductListingGroupVariant>;
+type ProductListingGroupsProductVariants = NonNullable<PublicProduct['variants']>;
+type ProductListingGroupsProduct = Omit<PublicProduct, 'variants'> & {
     id: string;
     slug: string;
     title: string;
+    variants?: (Omit<ProductListingGroupsProductVariants, 'docs'> & {
+        docs: ProductListingGroupVariant[];
+    }) | null;
 };
 type ProductListingGroupsItem = {
     product: ProductListingGroupsProduct;
     primaryOptionId: string | null;
+    listingGroupingState: ListingGroupingState;
     groups: ProductListingGroupSummary[];
 };
 type ProductListingGroupsResponse = {
+    /**
+     * Matching products in the same order as the requested productIds, excluding
+     * ids that were not found, not published, or not accessible for the current
+     * tenant/key.
+     */
     docs: ProductListingGroupsItem[];
+    /** Requested productIds that could not be returned. */
+    missing: string[];
 };
 type ProductDetailParams = {
     slug: string;
@@ -794,8 +812,9 @@ interface ProductDetail {
         content?: unknown;
         publishedAt?: string | null;
         status: string;
-        totalInventory: number;
+        totalInventory: number | null;
         totalVariants: number;
+        hasUnlimitedVariant: boolean;
         hasOnlyDefaultVariant: boolean;
     };
     variants: ProductDetailVariant[];
@@ -807,6 +826,14 @@ interface ProductDetail {
     videos: ProductDetailVideo[];
     listing: ProductDetailListing;
 }
+type ProductDetailUnavailableReason = 'not_found' | 'not_published' | 'feature_disabled';
+type ProductDetailResult = {
+    found: true;
+    product: ProductDetail;
+} | {
+    found: false;
+    reason: ProductDetailUnavailableReason;
+};
 type ProductUpsertOptionValueInput = {
     id?: string;
     value: string;
@@ -873,11 +900,15 @@ declare class ProductApi extends BaseApi {
     listingGroups(params: ListingGroupsParams): Promise<ProductListingGroupsResponse>;
     /**
      * Fetch full product detail by slug or id.
-     * Returns `null` on 404 regardless of reason (`not_found` / `not_published` /
-     * `tenant_mismatch` / `feature_disabled`). For the reason behind a null,
-     * inspect `client.lastRequestId` against backend logs.
+     * Returns a discriminated result so storefronts can distinguish missing,
+     * unpublished, and feature-disabled products.
+     *
+     * Only product-detail 404 responses carrying one of those allowlisted reasons
+     * are mapped to `{ found: false, reason }`. Unknown or uncoded 404s, plus
+     * permission/auth errors such as tenant mismatch, continue to throw typed SDK
+     * errors instead of being collapsed into a storefront absence result.
      */
-    detail(params: ProductDetailParams): Promise<ProductDetail | null>;
+    detail(params: ProductDetailParams): Promise<ProductDetailResult>;
     /**
      * Atomically create or update a product together with its options,
      * option-values, and variants in a single transaction. Mirrors Shopify's
@@ -936,12 +967,29 @@ type ReturnItem = {
     orderItem: string;
     quantity: number;
 };
+type OrderCreateEntityID = string | number;
+type CreateOrderItem = {
+    product: OrderCreateEntityID;
+    variant: OrderCreateEntityID;
+    option: OrderCreateEntityID;
+    quantity: number;
+    /**
+     * Compatibility input: the create-order endpoint accepts this, but the server
+     * derives authoritative line pricing from the product variant.
+     */
+    unitPrice?: number;
+    /**
+     * Compatibility input: the create-order endpoint accepts this, but the server
+     * derives authoritative line totals from the product variant.
+     */
+    totalPrice?: number;
+};
 type CreateOrderParams = {
     orderNumber: string;
     customer?: string;
     customerSnapshot: CustomerSnapshot;
     shippingAddress: Order['shippingAddress'];
-    orderItems: Pick<OrderItem, 'product' | 'variant' | 'quantity' | 'unitPrice' | 'totalPrice'>[];
+    orderItems: CreateOrderItem[];
     totalAmount: number;
     shippingAmount?: number;
     pgPaymentId?: string;
@@ -986,6 +1034,7 @@ type ReturnWithRefundItem = {
     orderItem: string | number;
     quantity: number;
     restockAction?: RestockAction;
+    restockingFee?: number;
 };
 type ReturnWithRefundParams = {
     orderNumber: string;
@@ -993,6 +1042,7 @@ type ReturnWithRefundParams = {
     reasonDetail?: string;
     returnItems: ReturnWithRefundItem[];
     refundAmount: number;
+    returnShippingFee?: number;
     pgPaymentId: string;
     paymentKey?: string;
     refundReceiptUrl?: string;
@@ -1077,7 +1127,7 @@ declare class CommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
-        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
     };
     readonly cart: {
         get: (cartId: string) => Promise<Cart>;
@@ -1286,4 +1336,4 @@ type DeepPartial<T> = {
 };
 type ExtractArrayType<T> = T extends (infer U)[] ? U : never;
 
-export { type OrderApiOptions as $, type ApiQueryOptions as A, BaseApi as B, CommerceClient as C, type DebugConfig as D, type ExtractArrayType as E, type CreateFulfillmentParams as F, type CreateOrderParams as G, type CreateReturnParams as H, CustomerAuth as I, type CustomerAuthOptions as J, type CustomerAuthResponse as K, type CustomerLoginData as L, type CustomerProfile as M, type CustomerRefreshResponse as N, type CustomerRegisterData as O, type PayloadFindResponse as P, type CustomerRegisterResponse as Q, type RetryConfig as R, type Sort as S, type CustomerSnapshot as T, DiscountApi as U, type DiscountApiOptions as V, type Where as W, type LegacyProductSelectionParamEvent as X, type ListingGroupsParams as Y, type NormalizedProductSelection as Z, OrderApi as _, CommunityClient as a, buildProductHref as a$, ProductApi as a0, type ProductApiOptions as a1, type ProductDetail as a2, type ProductDetailBrand as a3, type ProductDetailCategory as a4, type ProductDetailImage as a5, type ProductDetailImageMedia as a6, type ProductDetailListing as a7, type ProductDetailMedia as a8, type ProductDetailOption as a9, type ProductSelectionByOptionValue as aA, ProductSelectionCodecError as aB, type ProductSelectionCodecOptions as aC, type ProductSelectionInput as aD, type ProductSelectionResolution as aE, type ProductSelectionResolutionContext as aF, type ProductVariantShape as aG, type RemoveDiscountParams as aH, type RemoveItemParams as aI, type RequestOptions as aJ, type ReturnItem as aK, type ReturnReason as aL, type ReturnWithRefundParams as aM, type ServerApiOptions as aN, ShippingApi as aO, type ShippingApiOptions as aP, type StockCheckParams as aQ, type StockCheckResponse as aR, type StockCheckResult as aS, type UpdateFulfillmentParams as aT, type UpdateItemParams as aU, type UpdateOrderParams as aV, type UpdateProfileData as aW, type UpdateReturnParams as aX, type UpdateTransactionParams as aY, type ValidateDiscountParams as aZ, type ValidateDiscountResult as a_, type ProductDetailOptionValue as aa, type ProductDetailParams as ab, type ProductDetailTag as ac, type ProductDetailVariant as ad, type ProductDetailVariantOptionValue as ae, type ProductDetailVideo as af, type ProductHrefGroup as ag, type ProductHrefOptions as ah, type ProductHrefProduct as ai, type ProductListingCard as aj, type ProductListingCardPriceRange as ak, type ProductListingGroup as al, type ProductListingGroupSummary as am, type ProductListingGroupsItem as an, type ProductListingGroupsProduct as ao, type ProductListingGroupsResponse as ap, type ProductListingProductShape as aq, type ProductListingProjection as ar, type ProductListingSwatch as as, type ProductOptionMatrix as at, type ProductOptionMatrixOption as au, type ProductOptionMatrixValue as av, type ProductOptionMatrixVariant as aw, type ProductOptionShape as ax, type ProductOptionValueShape as ay, type ProductSelectionAvailableValue as az, CustomerNamespace as b, buildProductListingCard as b0, buildProductListingGroupsByOption as b1, buildProductListingProjection as b2, buildProductOptionMatrix as b3, buildProductOptionMatrixFromDetail as b4, createProductSelectionCodec as b5, getAvailableOptionValues as b6, getProductSelectionImages as b7, getSelectedValueByOptionId as b8, normalizeProductSelection as b9, normalizeProductSelectionFromMatrix as ba, normalizeSelectedValueIds as bb, parseProductSelection as bc, resolveProductSelection as bd, resolveProductSelectionFromMatrix as be, resolveVariantForSelection as bf, stringifyProductSelection as bg, type ProductDetailPreviewParams as bh, type ProductDetailPreviewOptions as bi, type ProductUpsertParams as bj, type ProductUpsertResponse as bk, type ClientServerConfig as bl, type ClientState as c, type ClientConfig as d, type ClientMetadata as e, type DeepPartial as f, type PayloadMutationResponse as g, type RootClient as h, type RootCollectionClient as i, type RootReadOnlyQueryBuilder as j, type AddItemParams as k, type ApplyDiscountParams as l, type BulkImportFulfillmentsParams as m, type BulkImportFulfillmentsResponse as n, type CalculateShippingParams as o, type CalculateShippingResult as p, CartApi as q, type CartApiOptions as r, type CheckoutParams as s, type ClearCartParams as t, type CommerceClientOptions as u, type CommunityClientOptions as v, type CommunityPost as w, type CompatibilityProductSelectionParamEvent as x, type ConfirmPaymentParams as y, type ConfirmPaymentResponse as z };
+export { type NormalizedProductSelection as $, type ApiQueryOptions as A, BaseApi as B, CommerceClient as C, type DebugConfig as D, type ExtractArrayType as E, type CreateFulfillmentParams as F, type CreateOrderItem as G, type CreateOrderParams as H, type CreateReturnParams as I, CustomerAuth as J, type CustomerAuthOptions as K, type CustomerAuthResponse as L, type CustomerLoginData as M, type CustomerProfile as N, type CustomerRefreshResponse as O, type PayloadFindResponse as P, type CustomerRegisterData as Q, type RetryConfig as R, type Sort as S, type CustomerRegisterResponse as T, type CustomerSnapshot as U, DiscountApi as V, type Where as W, type DiscountApiOptions as X, type LegacyProductSelectionParamEvent as Y, type ListingGroupingState as Z, type ListingGroupsParams as _, CommunityClient as a, type UpdateItemParams as a$, OrderApi as a0, type OrderApiOptions as a1, ProductApi as a2, type ProductApiOptions as a3, type ProductDetail as a4, type ProductDetailBrand as a5, type ProductDetailCategory as a6, type ProductDetailImage as a7, type ProductDetailImageMedia as a8, type ProductDetailListing as a9, type ProductOptionMatrixOption as aA, type ProductOptionMatrixValue as aB, type ProductOptionMatrixVariant as aC, type ProductOptionShape as aD, type ProductOptionValueShape as aE, type ProductSelectionAvailableValue as aF, type ProductSelectionByOptionValue as aG, ProductSelectionCodecError as aH, type ProductSelectionCodecOptions as aI, type ProductSelectionInput as aJ, type ProductSelectionResolution as aK, type ProductSelectionResolutionContext as aL, type ProductVariantShape as aM, type RemoveDiscountParams as aN, type RemoveItemParams as aO, type RequestOptions as aP, type ReturnItem as aQ, type ReturnReason as aR, type ReturnWithRefundItem as aS, type ReturnWithRefundParams as aT, type ServerApiOptions as aU, ShippingApi as aV, type ShippingApiOptions as aW, type StockCheckParams as aX, type StockCheckResponse as aY, type StockCheckResult as aZ, type UpdateFulfillmentParams as a_, type ProductDetailMedia as aa, type ProductDetailOption as ab, type ProductDetailOptionValue as ac, type ProductDetailParams as ad, type ProductDetailResult as ae, type ProductDetailTag as af, type ProductDetailUnavailableReason as ag, type ProductDetailVariant as ah, type ProductDetailVariantOptionValue as ai, type ProductDetailVideo as aj, type ProductHrefGroup as ak, type ProductHrefOptions as al, type ProductHrefProduct as am, type ProductListingCard as an, type ProductListingCardPriceRange as ao, type ProductListingCardRepresentativeVariant as ap, type ProductListingGroup as aq, type ProductListingGroupSummary as ar, type ProductListingGroupVariant as as, type ProductListingGroupsItem as at, type ProductListingGroupsProduct as au, type ProductListingGroupsResponse as av, type ProductListingProductShape as aw, type ProductListingProjection as ax, type ProductListingSwatch as ay, type ProductOptionMatrix as az, CustomerNamespace as b, type UpdateOrderParams as b0, type UpdateProfileData as b1, type UpdateReturnParams as b2, type UpdateTransactionParams as b3, type ValidateDiscountParams as b4, type ValidateDiscountResult as b5, buildProductHref as b6, buildProductListingCard as b7, buildProductListingGroupsByOption as b8, buildProductListingProjection as b9, buildProductOptionMatrix as ba, buildProductOptionMatrixFromDetail as bb, createProductSelectionCodec as bc, getAvailableOptionValues as bd, getProductSelectionImages as be, getSelectedValueByOptionId as bf, normalizeProductSelection as bg, normalizeProductSelectionFromMatrix as bh, normalizeSelectedValueIds as bi, parseProductSelection as bj, resolveProductSelection as bk, resolveProductSelectionFromMatrix as bl, resolveVariantForSelection as bm, stringifyProductSelection as bn, type ProductDetailPreviewParams as bo, type ProductDetailPreviewOptions as bp, type ProductUpsertParams as bq, type ProductUpsertResponse as br, type ClientServerConfig as bs, type ClientState as c, type ClientConfig as d, type ClientMetadata as e, type DeepPartial as f, type PayloadMutationResponse as g, type RootClient as h, type RootCollectionClient as i, type RootReadOnlyQueryBuilder as j, type AddItemParams as k, type ApplyDiscountParams as l, type BulkImportFulfillmentsParams as m, type BulkImportFulfillmentsResponse as n, type CalculateShippingParams as o, type CalculateShippingResult as p, CartApi as q, type CartApiOptions as r, type CheckoutParams as s, type ClearCartParams as t, type CommerceClientOptions as u, type CommunityClientOptions as v, type CommunityPost as w, type CompatibilityProductSelectionParamEvent as x, type ConfirmPaymentParams as y, type ConfirmPaymentResponse as z };

package/dist/{types-CVA10VC-.d.ts → types-Cel_4L9t.d.ts}

@@ -1,4 +1,4 @@
-import { P as Product, C as CustomerProfile, a as CustomerProfileList, b as ProductCollection, c as Post, d as Comment, R as Reaction, e as Config } from './payload-types-Wa4-eC6x.js';
+import { P as Product, C as CustomerProfile, a as CustomerProfileList, b as ProductCollection, c as Post, d as Comment, R as Reaction, e as Config } from './payload-types-dkeQyrDC.js';
 
 type PublicCustomerProfile = Omit<CustomerProfile, 'tenant' | 'customer' | 'isPublic' | 'anonymizedAt' | 'metadata'>;
 type PublicProfileRelation = string | PublicCustomerProfile;

package/dist/ui/form.d.cts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { F as Form } from '../payload-types-Wa4-eC6x.cjs';
+import { F as Form } from '../payload-types-dkeQyrDC.cjs';
 import { RichTextData } from './rich-text.cjs';
 import '@payloadcms/richtext-lexical';
 import '@payloadcms/richtext-lexical/lexical';

package/dist/ui/form.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { F as Form } from '../payload-types-Wa4-eC6x.js';
+import { F as Form } from '../payload-types-dkeQyrDC.js';
 import { RichTextData } from './rich-text.js';
 import '@payloadcms/richtext-lexical';
 import '@payloadcms/richtext-lexical/lexical';

package/dist/ui/video.d.cts

@@ -1,7 +1,7 @@
 import React, { CSSProperties } from 'react';
 import { MuxPlayerProps, MuxPlayerRefAttributes } from '@mux/mux-player-react';
 export { MuxPlayerRefAttributes as VideoPlayerRef } from '@mux/mux-player-react';
-import { V as Video } from '../payload-types-Wa4-eC6x.cjs';
+import { V as Video } from '../payload-types-dkeQyrDC.cjs';
 export { V as VideoGifOptions, a as VideoThumbnailOptions, g as getVideoGif, b as getVideoMp4Url, c as getVideoStoryboard, d as getVideoStreamUrl, e as getVideoThumbnail } from '../video-WR_TFO9a.cjs';
 
 interface VideoPlayerCSSProperties extends CSSProperties {

package/dist/ui/video.d.ts

@@ -1,7 +1,7 @@
 import React, { CSSProperties } from 'react';
 import { MuxPlayerProps, MuxPlayerRefAttributes } from '@mux/mux-player-react';
 export { MuxPlayerRefAttributes as VideoPlayerRef } from '@mux/mux-player-react';
-import { V as Video } from '../payload-types-Wa4-eC6x.js';
+import { V as Video } from '../payload-types-dkeQyrDC.js';
 export { V as VideoGifOptions, a as VideoThumbnailOptions, g as getVideoGif, b as getVideoMp4Url, c as getVideoStoryboard, d as getVideoStreamUrl, e as getVideoThumbnail } from '../video-WR_TFO9a.js';
 
 interface VideoPlayerCSSProperties extends CSSProperties {

package/dist/webhook.cjs

@@ -20,21 +20,162 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/webhook.ts
 var webhook_exports = {};
 __export(webhook_exports, {
+  COMMERCE_NOTIFICATION_EVENTS: () => COMMERCE_NOTIFICATION_EVENTS,
+  COMMERCE_NOTIFICATION_EVENT_TYPE: () => COMMERCE_NOTIFICATION_EVENT_TYPE,
+  COMMERCE_NOTIFICATION_OPERATION: () => COMMERCE_NOTIFICATION_OPERATION,
   CUSTOMER_PASSWORD_RESET_OPERATION: () => CUSTOMER_PASSWORD_RESET_OPERATION,
+  ORDER_CHANGED_EVENT_TYPE: () => ORDER_CHANGED_EVENT_TYPE,
+  createCommerceEmailWebhookHandler: () => createCommerceEmailWebhookHandler,
   createCustomerAuthWebhookHandler: () => createCustomerAuthWebhookHandler,
   createTypedWebhookHandler: () => createTypedWebhookHandler,
+  defineCommerceEmailConfig: () => defineCommerceEmailConfig,
+  getCommerceNotificationIdempotencyKey: () => getCommerceNotificationIdempotencyKey,
   handleWebhook: () => handleWebhook,
+  isCommerceNotificationWebhookEvent: () => isCommerceNotificationWebhookEvent,
   isCustomerPasswordResetWebhookEvent: () => isCustomerPasswordResetWebhookEvent,
-  isValidWebhookEvent: () => isValidWebhookEvent
+  isOrderChangedWebhookEvent: () => isOrderChangedWebhookEvent,
+  isValidWebhookEvent: () => isValidWebhookEvent,
+  isWebhookCollection: () => isWebhookCollection,
+  isWebhookOperation: () => isWebhookOperation
 });
 module.exports = __toCommonJS(webhook_exports);
 
 // src/core/webhook/index.ts
+var ORDER_CHANGED_EVENT_TYPE = "collection.orderChanged";
+var COMMERCE_NOTIFICATION_EVENT_TYPE = "commerce.notification";
 function isValidWebhookEvent(data) {
   if (typeof data !== "object" || data === null) return false;
   const obj = data;
   return typeof obj.collection === "string" && typeof obj.operation === "string" && obj.operation.length > 0 && typeof obj.data === "object" && obj.data !== null;
 }
+var COMMERCE_NOTIFICATION_OPERATION = "notification";
+var COMMERCE_NOTIFICATION_EVENTS = [
+  "orderPaid",
+  "fulfillmentShipped",
+  "orderDelivered",
+  "returnRequested",
+  "returnCompleted"
+];
+function isStringOrNumber(value) {
+  return typeof value === "string" || typeof value === "number";
+}
+function isWebhookOrderScope(value) {
+  if (!isRecord(value)) return false;
+  if (value.kind === "collection") {
+    return typeof value.collection === "string";
+  }
+  if (value.kind === "join") {
+    return typeof value.collection === "string" && typeof value.field === "string" && isStringOrNumber(value.id);
+  }
+  return false;
+}
+function isWebhookOrderMoved(value) {
+  if (!isRecord(value)) return false;
+  return typeof value.collection === "string" && isStringOrNumber(value.id) && (value.relatedCollection === void 0 || typeof value.relatedCollection === "string") && (value.relatedId === void 0 || isStringOrNumber(value.relatedId));
+}
+function hasOptionalOrderValue(value, key) {
+  return value[key] === void 0 || value[key] === null || typeof value[key] === "string";
+}
+function isWebhookOrderChange(value) {
+  if (!isRecord(value)) return false;
+  return value.type === "order" && value.source === "payload-orderable" && (value.orderableFieldName === void 0 || typeof value.orderableFieldName === "string") && hasOptionalOrderValue(value, "previousOrder") && hasOptionalOrderValue(value, "nextOrder") && isWebhookOrderScope(value.scope) && isWebhookOrderMoved(value.moved);
+}
+function isCommerceNotificationEventName(value) {
+  return typeof value === "string" && COMMERCE_NOTIFICATION_EVENTS.includes(value);
+}
+function isCommerceNotificationSourceCollection(value) {
+  return value === "orders" || value === "fulfillments" || value === "returns";
+}
+function isCommerceNotificationData(value) {
+  if (!isRecord(value)) return false;
+  if (value.source !== void 0 && (!isRecord(value.source) || !isCommerceNotificationSourceCollection(value.source.collection) || !isStringOrNumber(value.source.id))) {
+    return false;
+  }
+  return (value.orderId === void 0 || isStringOrNumber(value.orderId)) && (value.orderNumber === void 0 || typeof value.orderNumber === "string") && (value.status === void 0 || typeof value.status === "string") && (value.totalAmount === void 0 || typeof value.totalAmount === "number") && (value.currency === void 0 || typeof value.currency === "string") && (value.fulfillmentId === void 0 || isStringOrNumber(value.fulfillmentId)) && (value.fulfillmentStatus === void 0 || typeof value.fulfillmentStatus === "string") && (value.shippedAt === void 0 || typeof value.shippedAt === "string") && (value.returnId === void 0 || isStringOrNumber(value.returnId)) && (value.returnStatus === void 0 || typeof value.returnStatus === "string") && (value.refundAmount === void 0 || typeof value.refundAmount === "number") && (value.completedAt === void 0 || typeof value.completedAt === "string");
+}
+function isCommerceNotification(value) {
+  if (!isRecord(value)) return false;
+  return isCommerceNotificationEventName(value.event) && typeof value.intentId === "string" && value.intentId.length > 0 && typeof value.dedupeKey === "string" && value.dedupeKey.length > 0 && (value.orderId === void 0 || typeof value.orderId === "string") && (value.fulfillmentId === void 0 || typeof value.fulfillmentId === "string") && (value.returnId === void 0 || typeof value.returnId === "string");
+}
+function isWebhookCommerceNotificationChange(value) {
+  if (!isRecord(value)) return false;
+  return value.type === "notification" && value.source === "commerce-notifications" && isCommerceNotificationEventName(value.event) && isCommerceNotificationSourceCollection(value.sourceCollection) && isStringOrNumber(value.sourceId);
+}
+function matchesOptionalId(actual, expected) {
+  return actual === void 0 || expected === void 0 || actual === expected;
+}
+function isOrderChangedWebhookEvent(event) {
+  if (!isValidWebhookEvent(event) || event.operation !== "update" || event.eventType !== ORDER_CHANGED_EVENT_TYPE || !isWebhookOrderChange(event.change)) {
+    return false;
+  }
+  if (event.collection !== event.change.scope.collection) {
+    return false;
+  }
+  if (event.change.scope.kind === "collection" && event.change.moved.collection !== event.change.scope.collection) {
+    return false;
+  }
+  return true;
+}
+function isCommerceNotificationWebhookEvent(event) {
+  if (!isValidWebhookEvent(event) || event.operation !== COMMERCE_NOTIFICATION_OPERATION || event.eventType !== COMMERCE_NOTIFICATION_EVENT_TYPE || !isCommerceNotificationData(event.data) || !isCommerceNotification(event.notification)) {
+    return false;
+  }
+  const notification = event.notification;
+  const data = event.data;
+  const change = event.change;
+  const sourceCollection = data.source?.collection ?? event.collection;
+  const sourceId = data.source?.id;
+  if (!isCommerceNotificationSourceCollection(sourceCollection)) return false;
+  if (data.source !== void 0 && event.collection !== data.source.collection) {
+    return false;
+  }
+  if (change !== void 0) {
+    if (!isWebhookCommerceNotificationChange(change)) return false;
+    if (change.sourceCollection !== sourceCollection) return false;
+    if (change.event !== notification.event) return false;
+    if (!matchesOptionalId(change.sourceId, sourceId)) return false;
+  }
+  const changeSourceId = isWebhookCommerceNotificationChange(change) ? change.sourceId : void 0;
+  if (notification.event === "orderPaid" || notification.event === "orderDelivered") {
+    return sourceCollection === "orders" && typeof notification.orderId === "string" && notification.orderId.length > 0 && matchesOptionalId(data.orderId, sourceId) && matchesOptionalId(notification.orderId, sourceId) && matchesOptionalId(data.orderId, notification.orderId) && matchesOptionalId(changeSourceId, data.orderId ?? notification.orderId);
+  }
+  if (notification.event === "fulfillmentShipped") {
+    return sourceCollection === "fulfillments" && matchesOptionalId(data.fulfillmentId, sourceId) && typeof notification.fulfillmentId === "string" && notification.fulfillmentId.length > 0 && matchesOptionalId(notification.fulfillmentId, sourceId) && matchesOptionalId(data.fulfillmentId, notification.fulfillmentId) && matchesOptionalId(changeSourceId, notification.fulfillmentId);
+  }
+  if (notification.event === "returnRequested" || notification.event === "returnCompleted") {
+    return sourceCollection === "returns" && matchesOptionalId(data.returnId, sourceId) && typeof notification.returnId === "string" && notification.returnId.length > 0 && matchesOptionalId(notification.returnId, sourceId) && matchesOptionalId(data.returnId, notification.returnId) && matchesOptionalId(changeSourceId, notification.returnId);
+  }
+  return false;
+}
+function getCommerceNotificationIdempotencyKey(event) {
+  return `${event.notification.intentId}:${event.notification.dedupeKey}`;
+}
+function defineCommerceEmailConfig(config) {
+  return config;
+}
+function createCommerceEmailWebhookHandler(handlers) {
+  return async (event) => {
+    if (!isCommerceNotificationWebhookEvent(event)) {
+      await handlers.unhandled?.(event);
+      return;
+    }
+    const handler = handlers[event.notification.event];
+    if (!handler) {
+      await handlers.unhandled?.(event);
+      return;
+    }
+    await handler({
+      event,
+      idempotencyKey: getCommerceNotificationIdempotencyKey(event)
+    });
+  };
+}
+function isWebhookCollection(event, collection) {
+  return isValidWebhookEvent(event) && event.collection === collection;
+}
+function isWebhookOperation(event, operation) {
+  return isValidWebhookEvent(event) && event.operation === operation;
+}
 var CUSTOMER_PASSWORD_RESET_OPERATION = "password-reset";
 function isRecord(value) {
   return typeof value === "object" && value !== null;