@01.software/sdk 0.27.0 → 0.29.0

package/dist/server.d.cts

@@ -1,7 +1,7 @@
-export { z as ClientServerConfig, D as CollectionClient, m as CommunityClient, ad as ModerationApi, aL as ServerClient, aM as ServerCollectionClient, aO as ServerCommerceClient, bb as createServerClient } from './server-n3xK4Nks.cjs';
-import './payload-types-BPvUmPAq.cjs';
+export { E as ClientServerConfig, F as CollectionClient, o as CommunityClient, ag as ModerationApi, b4 as ServerClient, b5 as ServerCollectionClient, b7 as ServerCommerceClient, by as createServerClient } from './server-C0C8dtms.cjs';
+import './payload-types-Ci-ZA7aM.cjs';
 import '@tanstack/react-query';
 import 'payload';
 import 'next';
-import './types-DzWNu9pw.cjs';
-import './const-C0GlmeJ_.cjs';
+import './types-zKjATmDK.cjs';
+import './const-Dsixdi6z.cjs';

package/dist/server.d.ts

@@ -1,7 +1,7 @@
-export { z as ClientServerConfig, D as CollectionClient, m as CommunityClient, ad as ModerationApi, aL as ServerClient, aM as ServerCollectionClient, aO as ServerCommerceClient, bb as createServerClient } from './server-_zvihptw.js';
-import './payload-types-BPvUmPAq.js';
+export { E as ClientServerConfig, F as CollectionClient, o as CommunityClient, ag as ModerationApi, b4 as ServerClient, b5 as ServerCollectionClient, b7 as ServerCommerceClient, by as createServerClient } from './server-Cv0Q4dPQ.js';
+import './payload-types-Ci-ZA7aM.js';
 import '@tanstack/react-query';
 import 'payload';
 import 'next';
-import './types-BLdthWiW.js';
-import './const-D-xucnw4.js';
+import './types-BWq_WlbB.js';
+import './const-DAjQYNuM.js';

package/dist/server.js

@@ -1342,6 +1342,29 @@ 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
@@ -1434,7 +1457,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),
@@ -1536,10 +1561,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) {
@@ -1697,6 +1736,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,
@@ -1717,6 +1759,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,
@@ -1733,6 +1778,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,
@@ -1888,7 +1936,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);
@@ -1905,6 +1953,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;
@@ -1998,6 +2047,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 useQueryOriginal3({
+      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
@@ -2048,7 +2112,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 };