@01.software/sdk 0.26.0 → 0.28.0

package/dist/{server-DULueNYi.d.ts → server-D369bCVJ.d.cts}

@@ -1,10 +1,10 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { QueryClient, InfiniteData } from '@tanstack/react-query';
-import { O as Order, d as Cart, e as CartItem, f as Product, l as OrderItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-BF8VVFt6.js';
+import { QueryClient, InfiniteData, UseQueryResult } from '@tanstack/react-query';
+import { O as Order, d as Cart, e as CartItem, f as Product, l as OrderItem, m as Transaction, n as Fulfillment, o as Return } from './payload-types-BrSYb-sh.cjs';
 import { Sort, Where } from 'payload';
 import { Metadata } from 'next';
-import { C as CollectionType } from './types-CZ1laT6s.js';
-import { P as PublicCollection, S as ServerCollection } from './const-R3AyqOHY.js';
+import { C as CollectionType } from './types-CW4PaIL7.cjs';
+import { P as PublicCollection, d as ServerCollection } from './const-Cz9Ki_I7.cjs';
 
 declare function resolveApiUrl(): string;
 interface ClientConfig {
@@ -88,12 +88,51 @@ interface ApiQueryOptions {
     page?: number;
     limit?: number;
     sort?: Sort;
+    /**
+     * Filter documents. Id-based relation filters (`where: { product: { equals: id } }`) are the
+     * most reliable pattern. Dotted-path relation filters (`where: { 'product.slug': { equals } }`)
+     * are Payload-native but may silently return empty when access control restricts the related
+     * document or when the relation is polymorphic. String shorthand (`where: { slug: 'x' }`)
+     * silently matches nothing — always use `{ slug: { equals: 'x' } }`.
+     */
     where?: Where;
+    /**
+     * Controls how deeply relationship fields are populated. This is the primary control for
+     * populating relationships like `category`, `images`, `brand`. The configured Payload default
+     * applies when unset.
+     */
     depth?: number;
     select?: Record<string, boolean>;
-    /** Per-collection field selection for populated relationships (keyed by collection slug) */
+    /**
+     * Controls which fields are returned for already-populated relationships, keyed by collection
+     * slug. Does NOT control which relationships to populate — that is `depth`.
+     *
+     * @example
+     * // depth: 2 populates category; populate trims which fields come back
+     * populate: { categories: { title: true, slug: true } }
+     */
     populate?: Record<string, boolean | Record<string, boolean>>;
-    /** Join field control: pagination/filter per join, or false to disable */
+    /**
+     * Controls Payload `type: 'join'` virtual reverse-relation fields only (pagination, sort,
+     * filter, count per join field, or `false` to disable all join-field population).
+     *
+     * Does NOT populate normal relationship fields like `category`, `images`, or `brand`.
+     * For normal relationship population use `depth` (and optionally `populate` for field
+     * selection).
+     *
+     * Pass `joins: false` to disable all join-field population — useful for lightweight list
+     * queries where join fields are not needed.
+     *
+     * @example
+     * // `article-authors` has a `type: 'join'` field `articles` (reverse-relation)
+     * joins: { articles: { limit: 10, sort: '-publishedAt' } }
+     *
+     * // depth: 2 populates product.category — joins has no effect on this
+     * depth: 2
+     *
+     * // Disable all join-field population
+     * joins: false
+     */
     joins?: Record<string, {
         limit?: number;
         page?: number;
@@ -998,6 +1037,151 @@ type ProductListingGroupsItem = {
 type ProductListingGroupsResponse = {
     docs: ProductListingGroupsItem[];
 };
+type ProductDetailParams = {
+    slug: string;
+} | {
+    id: string;
+};
+interface ProductDetailVariantOptionValue {
+    optionId: string | number;
+    valueId: string | number;
+    value?: string | null;
+}
+interface ProductDetailVariant {
+    id: string | number;
+    optionKey: string;
+    title?: string | null;
+    displayName: string;
+    sku?: string | null;
+    price: number;
+    compareAtPrice?: number | null;
+    stock: number;
+    reservedStock: number;
+    isUnlimited: boolean;
+    thumbnail?: unknown | null;
+    images?: unknown[];
+    optionValues: ProductDetailVariantOptionValue[];
+}
+interface ProductDetailOptionValue {
+    id: string | number;
+    value: string;
+    swatchColor?: string | null;
+    thumbnail?: unknown | null;
+}
+interface ProductDetailOption {
+    id: string | number;
+    title: string;
+    values: ProductDetailOptionValue[];
+}
+interface ProductDetailBrand {
+    id: string | number;
+    name: string;
+    slug?: string | null;
+    logo?: unknown | null;
+}
+interface ProductDetailCategory {
+    id: string | number;
+    title: string;
+    slug?: string | null;
+}
+interface ProductDetailTag {
+    id: string | number;
+    title: string;
+    slug?: string | null;
+}
+interface ProductDetailImage {
+    id: string | number;
+    url?: string | null;
+    alt?: string | null;
+    width?: number | null;
+    height?: number | null;
+}
+interface ProductDetailVideo {
+    id: string | number;
+    url?: string | null;
+}
+interface ProductDetailListing {
+    minPrice?: number | null;
+    maxPrice?: number | null;
+    minCompareAtPrice?: number | null;
+    maxCompareAtPrice?: number | null;
+    isPriceRange?: boolean | null;
+    primaryImage?: unknown | null;
+    availableForSale?: boolean | null;
+    selectionHintVariant?: unknown | null;
+}
+interface ProductDetail {
+    product: {
+        id: string | number;
+        slug: string;
+        title: string;
+        subtitle?: string | null;
+        description?: string | null;
+        content?: unknown;
+        publishedAt?: string | null;
+        status: string;
+        totalInventory: number;
+        totalVariants: number;
+        hasOnlyDefaultVariant: boolean;
+    };
+    variants: ProductDetailVariant[];
+    options: ProductDetailOption[];
+    brand: ProductDetailBrand | null;
+    categories: ProductDetailCategory[];
+    tags: ProductDetailTag[];
+    images: ProductDetailImage[];
+    videos: ProductDetailVideo[];
+    listing: ProductDetailListing;
+}
+type ProductUpsertOptionValueInput = {
+    id?: string;
+    value: string;
+    slug?: string;
+    swatchColor?: string | null;
+    thumbnail?: string | null;
+    images?: string[];
+    metadata?: unknown;
+};
+type ProductUpsertOptionInput = {
+    id?: string;
+    title: string;
+    values: ProductUpsertOptionValueInput[];
+};
+type ProductUpsertVariantInput = {
+    id?: string;
+    optionValues?: Record<string, string> | string[];
+    sku?: string | null;
+    title?: string | null;
+    price: number;
+    compareAtPrice?: number | null;
+    stock?: number;
+    isUnlimited?: boolean;
+    weight?: number | null;
+    requiresShipping?: boolean;
+    barcode?: string | null;
+    externalId?: string | null;
+    isActive?: boolean;
+    thumbnail?: string | null;
+    images?: string[];
+    metadata?: unknown;
+};
+type ProductUpsertParams = {
+    product: Record<string, unknown> & {
+        id?: string;
+        title?: string;
+    };
+    options?: ProductUpsertOptionInput[];
+    variants?: ProductUpsertVariantInput[];
+};
+type ProductUpsertResponse = {
+    ok: true;
+    product: Product;
+} | {
+    ok: false;
+    failedEntity: 'product' | 'option' | 'option-value' | 'variant';
+    failedIndex?: number;
+    message: string;
+};
 declare class ProductApi extends BaseApi {
     constructor(options: ProductApiOptions);
     /**
@@ -1007,6 +1191,20 @@ declare class ProductApi extends BaseApi {
      */
     stockCheck(params: StockCheckParams): Promise<StockCheckResponse>;
     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.
+     */
+    detail(params: ProductDetailParams): Promise<ProductDetail | null>;
+    /**
+     * Atomically create or update a product together with its options,
+     * option-values, and variants in a single transaction. Mirrors Shopify's
+     * `productSet` shape and is the canonical write path for the MCP
+     * `product-upsert` tool.
+     */
+    upsert(params: ProductUpsertParams): Promise<ProductUpsertResponse>;
 }
 
 type DiscountApiOptions = ServerApiOptions;
@@ -1082,6 +1280,27 @@ type UpdateTransactionParams = {
     paymentKey?: string;
     amount?: number;
 };
+type ConfirmPaymentParams = {
+    orderNumber?: string;
+    pgPaymentId: string;
+    pgProvider: string;
+    pgOrderId?: string;
+    amount: number;
+    currency?: string;
+    paymentMethod?: string;
+    receiptUrl?: string;
+    approvedAt?: string;
+    providerStatus?: string;
+    providerEventId?: string;
+    confirmationSource?: 'provider_webhook' | 'provider_lookup' | 'provider_api_confirm' | 'manual_server';
+    metadata?: Record<string, unknown>;
+};
+type ConfirmPaymentResponse = {
+    orderId: string;
+    transactionId: string;
+    status: 'paid';
+    alreadyConfirmed?: boolean;
+};
 type RestockAction = 'return_to_stock' | 'discard';
 type ReturnWithRefundItem = {
     orderItem: string | number;
@@ -1153,6 +1372,7 @@ declare class OrderApi extends BaseApi {
     createOrder(params: CreateOrderParams): Promise<Order>;
     updateOrder(params: UpdateOrderParams): Promise<Order>;
     updateTransaction(params: UpdateTransactionParams): Promise<Transaction>;
+    confirmPayment(params: ConfirmPaymentParams): Promise<ConfirmPaymentResponse>;
     checkout(params: CheckoutParams): Promise<Order>;
     createFulfillment(params: CreateFulfillmentParams): Promise<Fulfillment>;
     updateFulfillment(params: UpdateFulfillmentParams): Promise<Fulfillment>;
@@ -1174,6 +1394,8 @@ declare class ServerCommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+        upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
     };
     readonly cart: {
         get: (cartId: string) => Promise<Cart>;
@@ -1193,6 +1415,7 @@ declare class ServerCommerceClient {
         create: (params: CreateOrderParams) => Promise<Order>;
         update: (params: UpdateOrderParams) => Promise<Order>;
         updateTransaction: (params: UpdateTransactionParams) => Promise<Transaction>;
+        confirmPayment: (params: ConfirmPaymentParams) => Promise<ConfirmPaymentResponse>;
         createFulfillment: (params: CreateFulfillmentParams) => Promise<Fulfillment>;
         updateFulfillment: (params: UpdateFulfillmentParams) => Promise<Fulfillment>;
         bulkImportFulfillments: (params: BulkImportFulfillmentsParams) => Promise<BulkImportFulfillmentsResponse>;
@@ -1348,9 +1571,15 @@ type ReadOnlyQueryHooks = Omit<QueryHooks, 'useCreate' | 'useUpdate' | 'useRemov
  * Composes CollectionHooks + CustomerHooks into a single API surface.
  * All methods are delegated; no logic lives here.
  */
+interface ProductDetailCallable {
+    product: {
+        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+    };
+}
 declare class QueryHooks extends CollectionHooks {
     private _customer;
-    constructor(queryClient: QueryClient, collectionClient: CollectionClient, customerAuth?: CustomerAuth);
+    private _commerce?;
+    constructor(queryClient: QueryClient, collectionClient: CollectionClient, customerAuth?: CustomerAuth, commerceClient?: ProductDetailCallable);
     useCustomerMe: CustomerHooks['useCustomerMe'];
     useCustomerLogin: CustomerHooks['useCustomerLogin'];
     useCustomerRegister: CustomerHooks['useCustomerRegister'];
@@ -1365,7 +1594,7 @@ declare class QueryHooks extends CollectionHooks {
     setCustomerData: CustomerHooks['setCustomerData'];
     useProductListingGroupsQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
         options?: ProductListingGroupsQueryOptions;
-    }, options?: QueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): _tanstack_react_query.UseQueryResult<_tanstack_react_query.NoInfer<TData>, Error>;
+    }, options?: QueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): UseQueryResult<_tanstack_react_query.NoInfer<TData>, Error>;
     useSuspenseProductListingGroupsQuery<TData = PayloadFindResponse<ProductListingGroupsItem>>(params: {
         options?: ProductListingGroupsQueryOptions;
     }, options?: SuspenseQueryOptions<PayloadFindResponse<ProductListingGroupsItem>, TData>): _tanstack_react_query.UseSuspenseQueryResult<TData, Error>;
@@ -1389,6 +1618,19 @@ declare class QueryHooks extends CollectionHooks {
         pages?: number;
         staleTime?: number;
     }): Promise<void>;
+    useProductDetail(params: {
+        slug: string;
+    } | {
+        id: string;
+    }, options?: {
+        enabled?: boolean;
+    }): UseQueryResult<ProductDetail | null>;
+    useProductDetailBySlug(slug: string, options?: {
+        enabled?: boolean;
+    }): UseQueryResult<ProductDetail | null>;
+    useProductDetailById(id: string, options?: {
+        enabled?: boolean;
+    }): UseQueryResult<ProductDetail | null>;
 }
 
 declare class ServerClient {
@@ -1417,4 +1659,4 @@ declare class ServerClient {
  */
 declare function createServerClient(options: ClientServerConfig): ServerClient;
 
-export { isPermissionError as $, type AddItemParams as A, PermissionError as B, CustomerAuth as C, type DeepPartial as D, type ExtractArrayType as E, NotFoundError as F, GoneError as G, ConflictError as H, RateLimitError as I, isSDKError as J, isNetworkError as K, type ListingGroupsParams as L, isValidationError as M, NetworkError as N, isApiError as O, type ProductListingGroupsResponse as P, isConfigError as Q, type RemoveItemParams as R, type StockCheckParams as S, TimeoutError as T, type UpdateItemParams as U, type ValidateDiscountParams as V, isTimeoutError as W, isGoneError as X, isServiceUnavailableError as Y, isUsageLimitError as Z, isAuthError as _, type CustomerAuthOptions as a, type CustomerRegisterData as a$, isNotFoundError as a0, isConflictError as a1, isRateLimitError as a2, createAuthError as a3, createPermissionError as a4, createNotFoundError as a5, createConflictError as a6, createRateLimitError as a7, createServerClient as a8, ServerClient as a9, type ShippingApiOptions as aA, CartApi as aB, type CartApiOptions as aC, ProductApi as aD, type ProductApiOptions as aE, type ProductListingGroupSummary as aF, type ProductListingGroupsItem as aG, type StockCheckResult as aH, CollectionQueryBuilder as aI, ServerCollectionQueryBuilder as aJ, type ReadOnlyQueryBuilder as aK, CollectionClient as aL, ServerCollectionClient as aM, type GenerateMetadataOptions as aN, ServerCommerceClient as aO, type ServerCommerceClientOptions as aP, type CommunityClientOptions as aQ, type CommunityPost as aR, ModerationApi as aS, type ModerationApiOptions as aT, type CommunityBan as aU, type BanCustomerParams as aV, type UnbanCustomerParams as aW, type CustomerAuthResponse as aX, type CustomerRefreshResponse as aY, type CustomerRegisterResponse as aZ, type CustomerProfile as a_, resolveApiUrl as aa, type ClientServerConfig as ab, type ClientMetadata as ac, type PaginationMeta as ad, type PayloadMutationResponse as ae, BaseApi as af, type ServerApiOptions as ag, type RequestOptions as ah, OrderApi as ai, type OrderApiOptions as aj, type CustomerSnapshot as ak, type ReturnReason as al, type ReturnItem as am, type CreateOrderParams as an, type UpdateOrderParams as ao, type BulkImportFulfillmentsParams as ap, type BulkImportFulfillmentsResponse as aq, type CreateReturnParams as ar, type UpdateReturnParams as as, type UpdateTransactionParams as at, type CreateFulfillmentParams as au, type ReturnWithRefundParams as av, type UpdateFulfillmentParams as aw, DiscountApi as ax, type DiscountApiOptions as ay, ShippingApi as az, type StockCheckResponse as b, type CustomerLoginData as b0, type UpdateProfileData as b1, type CollectionQueryParams as b2, type CollectionDetailQueryParams as b3, type CollectionInfiniteQueryParams as b4, type QueryOptions as b5, type SuspenseQueryOptions as b6, type InfiniteQueryOptions as b7, type SuspenseInfiniteQueryOptions as b8, CollectionHooks as b9, CustomerHooks as ba, QueryHooks as bb, type ProductOptionValueShape as bc, type ProductOptionShape as bd, type ProductVariantShape as be, type ProductListingProductShape as bf, type ProductOptionMatrixValue as bg, type ProductOptionMatrixOption as bh, type ProductOptionMatrixVariant as bi, type ProductOptionMatrix as bj, type ProductListingProjection as bk, type ProductListingGroup as bl, buildProductOptionMatrix as bm, getSelectedValueByOptionId as bn, normalizeSelectedValueIds as bo, getAvailableOptionValues as bp, resolveVariantForSelection as bq, buildProductListingProjection as br, buildProductListingGroupsByOption as bs, type ApplyDiscountParams as c, type RemoveDiscountParams as d, type ClearCartParams as e, type CheckoutParams as f, type PayloadFindResponse as g, type ValidateDiscountResult as h, type CalculateShippingParams as i, type CalculateShippingResult as j, type ApiQueryOptions as k, type ProductListingGroupsQueryOptions as l, type ClientConfig as m, CommunityClient as n, type ReadOnlyQueryHooks as o, ReadOnlyCollectionClient as p, type ClientState as q, type DebugConfig as r, type RetryConfig as s, SDKError as t, ValidationError as u, ApiError as v, ConfigError as w, ServiceUnavailableError as x, UsageLimitError as y, AuthError as z };
+export { type CustomerAuthResponse as $, type AddItemParams as A, type BanCustomerParams as B, CustomerAuth as C, type ClientMetadata as D, type ClientServerConfig as E, CollectionClient as F, type CollectionDetailQueryParams as G, CollectionHooks as H, type CollectionInfiniteQueryParams as I, CollectionQueryBuilder as J, type CollectionQueryParams as K, type ListingGroupsParams as L, type CommunityBan as M, type CommunityClientOptions as N, type CommunityPost as O, type ProductListingGroupsResponse as P, ConfigError as Q, type RemoveItemParams as R, type StockCheckParams as S, type ConfirmPaymentParams as T, type UpdateItemParams as U, type ValidateDiscountParams as V, type ConfirmPaymentResponse as W, ConflictError as X, type CreateFulfillmentParams as Y, type CreateOrderParams as Z, type CreateReturnParams as _, type CustomerAuthOptions as a, type ServerCommerceClientOptions as a$, CustomerHooks as a0, type CustomerLoginData as a1, type CustomerProfile as a2, type CustomerRefreshResponse as a3, type CustomerRegisterData as a4, type CustomerRegisterResponse as a5, type CustomerSnapshot as a6, type DebugConfig as a7, type DeepPartial as a8, DiscountApi as a9, type ProductListingGroup as aA, type ProductListingGroupSummary as aB, type ProductListingGroupsItem as aC, type ProductListingProductShape as aD, type ProductListingProjection as aE, type ProductOptionMatrix as aF, type ProductOptionMatrixOption as aG, type ProductOptionMatrixValue as aH, type ProductOptionMatrixVariant as aI, type ProductOptionShape as aJ, type ProductOptionValueShape as aK, type ProductVariantShape as aL, QueryHooks as aM, type QueryOptions as aN, RateLimitError as aO, type ReadOnlyQueryBuilder as aP, type RequestOptions as aQ, type RetryConfig as aR, type ReturnItem as aS, type ReturnReason as aT, type ReturnWithRefundParams as aU, SDKError as aV, type ServerApiOptions as aW, ServerClient as aX, ServerCollectionClient as aY, ServerCollectionQueryBuilder as aZ, ServerCommerceClient as a_, type DiscountApiOptions as aa, type ExtractArrayType as ab, type GenerateMetadataOptions as ac, GoneError as ad, type InfiniteQueryOptions as ae, ModerationApi as af, type ModerationApiOptions as ag, NetworkError as ah, NotFoundError as ai, OrderApi as aj, type OrderApiOptions as ak, type PaginationMeta as al, type PayloadMutationResponse as am, PermissionError as an, ProductApi as ao, type ProductApiOptions as ap, type ProductDetailBrand as aq, type ProductDetailCategory as ar, type ProductDetailImage as as, type ProductDetailListing as at, type ProductDetailOption as au, type ProductDetailOptionValue as av, type ProductDetailTag as aw, type ProductDetailVariant as ax, type ProductDetailVariantOptionValue as ay, type ProductDetailVideo as az, type StockCheckResponse as b, ServiceUnavailableError as b0, ShippingApi as b1, type ShippingApiOptions as b2, type StockCheckResult as b3, type SuspenseInfiniteQueryOptions as b4, type SuspenseQueryOptions as b5, TimeoutError as b6, type UnbanCustomerParams as b7, type UpdateFulfillmentParams as b8, type UpdateOrderParams as b9, isServiceUnavailableError as bA, isTimeoutError as bB, isUsageLimitError as bC, isValidationError as bD, normalizeSelectedValueIds as bE, resolveApiUrl as bF, resolveVariantForSelection as bG, type UpdateProfileData as ba, type UpdateReturnParams as bb, type UpdateTransactionParams as bc, UsageLimitError as bd, ValidationError as be, buildProductListingGroupsByOption as bf, buildProductListingProjection as bg, buildProductOptionMatrix as bh, createAuthError as bi, createConflictError as bj, createNotFoundError as bk, createPermissionError as bl, createRateLimitError as bm, createServerClient as bn, getAvailableOptionValues as bo, getSelectedValueByOptionId as bp, isApiError as bq, isAuthError as br, isConfigError as bs, isConflictError as bt, isGoneError as bu, isNetworkError as bv, isNotFoundError as bw, isPermissionError as bx, isRateLimitError as by, isSDKError as bz, type ProductDetailParams as c, type ProductDetail as d, type ApplyDiscountParams as e, type RemoveDiscountParams as f, type ClearCartParams as g, type CheckoutParams as h, type PayloadFindResponse as i, type ValidateDiscountResult as j, type CalculateShippingParams as k, type CalculateShippingResult as l, type ApiQueryOptions as m, type ProductListingGroupsQueryOptions as n, CommunityClient as o, type ReadOnlyQueryHooks as p, ReadOnlyCollectionClient as q, type ClientState as r, type ClientConfig as s, ApiError as t, AuthError as u, BaseApi as v, type BulkImportFulfillmentsParams as w, type BulkImportFulfillmentsResponse as x, CartApi as y, type CartApiOptions as z };

package/dist/server.cjs

@@ -1374,6 +1374,32 @@ var ProductApi = class extends BaseApi {
       params
     );
   }
+  /**
+   * 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.
+   */
+  async detail(params) {
+    try {
+      return await this.request("/api/products/detail", params);
+    } catch (err) {
+      if (err instanceof NotFoundError) return null;
+      throw err;
+    }
+  }
+  /**
+   * Atomically create or update a product together with its options,
+   * option-values, and variants in a single transaction. Mirrors Shopify's
+   * `productSet` shape and is the canonical write path for the MCP
+   * `product-upsert` tool.
+   */
+  upsert(params) {
+    return this.request(
+      "/api/products/upsert",
+      params
+    );
+  }
 };
 
 // src/core/api/discount-api.ts
@@ -1410,6 +1436,13 @@ var OrderApi = class extends BaseApi {
   updateTransaction(params) {
     return this.request("/api/transactions/update", params);
   }
+  confirmPayment(params) {
+    return this.request(
+      "/api/orders/confirm-payment",
+      params,
+      params.providerEventId ? { headers: { "X-Idempotency-Key": params.providerEventId } } : void 0
+    );
+  }
   checkout(params) {
     return this.request("/api/orders/checkout", params);
   }
@@ -1459,7 +1492,9 @@ var ServerCommerceClient = class {
     const orderApi = new OrderApi(serverOptions);
     this.product = {
       stockCheck: productApi.stockCheck.bind(productApi),
-      listingGroups: productApi.listingGroups.bind(productApi)
+      listingGroups: productApi.listingGroups.bind(productApi),
+      detail: productApi.detail.bind(productApi),
+      upsert: productApi.upsert.bind(productApi)
     };
     this.cart = {
       get: cartApi.getCart.bind(cartApi),
@@ -1475,6 +1510,7 @@ var ServerCommerceClient = class {
       create: orderApi.createOrder.bind(orderApi),
       update: orderApi.updateOrder.bind(orderApi),
       updateTransaction: orderApi.updateTransaction.bind(orderApi),
+      confirmPayment: orderApi.confirmPayment.bind(orderApi),
       createFulfillment: orderApi.createFulfillment.bind(orderApi),
       updateFulfillment: orderApi.updateFulfillment.bind(orderApi),
       bulkImportFulfillments: orderApi.bulkImportFulfillments.bind(orderApi),
@@ -1545,10 +1581,24 @@ var customerKeys = {
 };
 var productKeys = {
   listingGroups: (options) => ["products", "listing-groups", "list", options],
-  listingGroupsInfinite: (options) => ["products", "listing-groups", "infinite", options]
+  listingGroupsInfinite: (options) => ["products", "listing-groups", "infinite", options],
+  detail: (params) => ["products", "detail", params],
+  detailAll: () => ["products", "detail"]
 };
 
 // src/core/query/collection-hooks.ts
+var PRODUCT_DETAIL_INVALIDATING_COLLECTIONS = /* @__PURE__ */ new Set([
+  "products",
+  "product-variants",
+  "product-options",
+  "product-option-values",
+  "product-categories",
+  "product-tags",
+  "product-collections",
+  "brands",
+  "brand-logos",
+  "images"
+]);
 var DEFAULT_PAGE_SIZE = 20;
 var CollectionHooks = class {
   constructor(queryClient, collectionClient) {
@@ -1706,6 +1756,9 @@ var CollectionHooks = class {
         this.queryClient.invalidateQueries({
           queryKey: collectionKeys(collection).all
         });
+        if (PRODUCT_DETAIL_INVALIDATING_COLLECTIONS.has(collection)) {
+          this.queryClient.invalidateQueries({ queryKey: ["products", "detail"] });
+        }
         options?.onSuccess?.(data);
       },
       onError: options?.onError,
@@ -1726,6 +1779,9 @@ var CollectionHooks = class {
         this.queryClient.invalidateQueries({
           queryKey: collectionKeys(collection).all
         });
+        if (PRODUCT_DETAIL_INVALIDATING_COLLECTIONS.has(collection)) {
+          this.queryClient.invalidateQueries({ queryKey: ["products", "detail"] });
+        }
         options?.onSuccess?.(data);
       },
       onError: options?.onError,
@@ -1742,6 +1798,9 @@ var CollectionHooks = class {
         this.queryClient.invalidateQueries({
           queryKey: collectionKeys(collection).all
         });
+        if (PRODUCT_DETAIL_INVALIDATING_COLLECTIONS.has(collection)) {
+          this.queryClient.invalidateQueries({ queryKey: ["products", "detail"] });
+        }
         options?.onSuccess?.(data);
       },
       onError: options?.onError,
@@ -1894,7 +1953,7 @@ var CustomerHooks = class {
 
 // src/core/query/query-hooks.ts
 var QueryHooks = class extends CollectionHooks {
-  constructor(queryClient, collectionClient, customerAuth) {
+  constructor(queryClient, collectionClient, customerAuth, commerceClient) {
     super(queryClient, collectionClient);
     // --- Customer hooks delegation ---
     this.useCustomerMe = (...args) => this._customer.useCustomerMe(...args);
@@ -1911,6 +1970,7 @@ var QueryHooks = class extends CollectionHooks {
     this.getCustomerData = () => this._customer.getCustomerData();
     this.setCustomerData = (data) => this._customer.setCustomerData(data);
     this._customer = new CustomerHooks(queryClient, customerAuth);
+    this._commerce = commerceClient;
   }
   useProductListingGroupsQuery(params, options) {
     const queryOptions = params.options;
@@ -2004,6 +2064,21 @@ var QueryHooks = class extends CollectionHooks {
       staleTime: options?.staleTime
     });
   }
+  useProductDetail(params, options) {
+    const discriminator = "slug" in params ? params.slug : params.id;
+    const enabled = options?.enabled !== false && Boolean(discriminator);
+    return (0, import_react_query4.useQuery)({
+      queryKey: productKeys.detail(params),
+      queryFn: () => this._commerce.product.detail(params),
+      enabled
+    });
+  }
+  useProductDetailBySlug(slug, options) {
+    return this.useProductDetail({ slug }, options);
+  }
+  useProductDetailById(id, options) {
+    return this.useProductDetail({ id }, options);
+  }
 };
 
 // src/core/client/client.server.ts
@@ -2054,7 +2129,7 @@ var ServerClient = class {
       onRequestId
     );
     this.queryClient = getQueryClient();
-    this.query = new QueryHooks(this.queryClient, this.collections);
+    this.query = new QueryHooks(this.queryClient, this.collections, void 0, this.commerce);
   }
   getState() {
     return { ...this.state };