@01.software/sdk 0.26.0 → 0.28.0

package/dist/{const-CEiFBZMW.d.cts → const-mdQQtIOz.d.ts}

@@ -1,4 +1,4 @@
-import { c as Config } from './payload-types-BF8VVFt6.cjs';
+import { c as Config } from './payload-types-BrSYb-sh.js';
 
 /**
  * Collection type derived from Payload Config.
@@ -9,26 +9,26 @@ type Collection = keyof Config['collections'];
  * Internal collections that should not be exposed via SDK.
  * Includes Payload system collections and admin-only collections.
  */
-declare const INTERNAL_COLLECTIONS: readonly ["users", "payload-kv", "payload-locked-documents", "payload-preferences", "payload-migrations", "payload-folders", "field-configs", "system-media", "track-assets", "audiences", "email-logs", "api-usage", "tenant-analytics-daily", "tenant-web-analytics-config", "analytics-event-schemas", "subscriptions", "billing-history", "order-status-logs", "api-keys", "personal-access-tokens", "tenant-entitlements", "tenant-purge-jobs", "direct-upload-sessions", "webhook-events", "webhook-deliveries", "audit-logs", "plans", "webhooks", "event-registrations"];
+declare const INTERNAL_COLLECTIONS: readonly ["users", "payload-kv", "payload-locked-documents", "payload-preferences", "payload-migrations", "payload-folders", "field-configs", "system-media", "track-assets", "audiences", "email-logs", "api-usage", "tenant-analytics-daily", "tenant-web-analytics-config", "analytics-event-schemas", "subscriptions", "billing-history", "inventory-reservations", "order-status-logs", "api-keys", "personal-access-tokens", "tenant-entitlements", "tenant-purge-jobs", "direct-upload-sessions", "webhook-events", "webhook-deliveries", "audit-logs", "plans", "webhooks", "event-registrations"];
 type InternalCollection = (typeof INTERNAL_COLLECTIONS)[number];
 /**
  * Array of all public collection names for runtime use (e.g., Zod enum validation).
  * This is the single source of truth for which collections are publicly accessible via SDK.
  */
-declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-items", "returns", "return-items", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-profiles", "customer-profile-lists", "customer-addresses", "carts", "cart-items", "discounts", "promotions", "shipping-policies", "documents", "document-categories", "document-types", "articles", "article-authors", "article-categories", "article-tags", "playlists", "playlist-categories", "playlist-tags", "tracks", "track-categories", "track-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "canvases", "canvas-node-types", "canvas-edge-types", "canvas-categories", "canvas-tags", "canvas-nodes", "canvas-edges", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions", "posts", "comments", "reactions", "reaction-types", "bookmarks", "post-categories", "reports", "community-bans", "event-calendars", "events", "event-categories", "event-occurrences", "event-tags"];
+declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-items", "returns", "return-items", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-profiles", "customer-profile-lists", "customer-addresses", "carts", "cart-items", "discounts", "shipping-policies", "shipping-zones", "documents", "document-categories", "document-types", "articles", "article-authors", "article-categories", "article-tags", "playlists", "playlist-categories", "playlist-tags", "tracks", "track-categories", "track-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "canvases", "canvas-node-types", "canvas-edge-types", "canvas-categories", "canvas-tags", "canvas-nodes", "canvas-edges", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions", "posts", "comments", "reactions", "reaction-types", "bookmarks", "post-categories", "event-calendars", "events", "event-categories", "event-occurrences", "event-tags"];
 /**
  * Server-auth collection names for runtime use. These collections are safe for
  * secret-key/PAT SDK and MCP server tools, but must not appear in browser or
  * publishable-key collection discovery.
  */
-declare const SERVER_ONLY_COLLECTIONS: readonly ["customer-groups"];
+declare const SERVER_ONLY_COLLECTIONS: readonly ["customer-groups", "reports", "community-bans"];
 /**
  * Public collections available for SDK access.
  * Derived from the COLLECTIONS array (single source of truth).
  */
 type PublicCollection = (typeof COLLECTIONS)[number];
 type ServerOnlyCollection = (typeof SERVER_ONLY_COLLECTIONS)[number];
-declare const SERVER_COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-items", "returns", "return-items", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-profiles", "customer-profile-lists", "customer-addresses", "carts", "cart-items", "discounts", "promotions", "shipping-policies", "documents", "document-categories", "document-types", "articles", "article-authors", "article-categories", "article-tags", "playlists", "playlist-categories", "playlist-tags", "tracks", "track-categories", "track-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "canvases", "canvas-node-types", "canvas-edge-types", "canvas-categories", "canvas-tags", "canvas-nodes", "canvas-edges", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions", "posts", "comments", "reactions", "reaction-types", "bookmarks", "post-categories", "reports", "community-bans", "event-calendars", "events", "event-categories", "event-occurrences", "event-tags", "customer-groups"];
+declare const SERVER_COLLECTIONS: readonly ["tenants", "tenant-metadata", "tenant-logos", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "brand-logos", "orders", "order-items", "returns", "return-items", "fulfillments", "fulfillment-items", "transactions", "customers", "customer-profiles", "customer-profile-lists", "customer-addresses", "carts", "cart-items", "discounts", "shipping-policies", "shipping-zones", "documents", "document-categories", "document-types", "articles", "article-authors", "article-categories", "article-tags", "playlists", "playlist-categories", "playlist-tags", "tracks", "track-categories", "track-tags", "galleries", "gallery-categories", "gallery-tags", "gallery-items", "links", "link-categories", "link-tags", "canvases", "canvas-node-types", "canvas-edge-types", "canvas-categories", "canvas-tags", "canvas-nodes", "canvas-edges", "videos", "video-categories", "video-tags", "live-streams", "images", "forms", "form-submissions", "posts", "comments", "reactions", "reaction-types", "bookmarks", "post-categories", "event-calendars", "events", "event-categories", "event-occurrences", "event-tags", "customer-groups", "reports", "community-bans"];
 type ServerCollection = (typeof SERVER_COLLECTIONS)[number];
 
-export { type Collection as C, INTERNAL_COLLECTIONS as I, type PublicCollection as P, type ServerCollection as S, type ServerOnlyCollection as a, COLLECTIONS as b, SERVER_ONLY_COLLECTIONS as c, SERVER_COLLECTIONS as d, type InternalCollection as e };
+export { COLLECTIONS as C, INTERNAL_COLLECTIONS as I, type PublicCollection as P, SERVER_COLLECTIONS as S, type Collection as a, type InternalCollection as b, SERVER_ONLY_COLLECTIONS as c, type ServerCollection as d, type ServerOnlyCollection as e };

package/dist/{image-TT8lTsk5.d.cts → image-BDz2-AaO.d.cts}

@@ -79,4 +79,4 @@ interface ImagePlaceholderOptions {
  */
 declare function getImagePlaceholderStyle(image: ImageData, options?: ImagePlaceholderOptions): Record<string, string>;
 
-export { type ImageData as I, type ImagePalette as a, IMAGE_SIZES as b, getImageSrcSet as c, getImageLqip as d, getImagePalette as e, type ImagePlaceholderOptions as f, getImageUrl as g, getImagePlaceholderStyle as h };
+export { type ImageData as I, IMAGE_SIZES as a, type ImagePalette as b, type ImagePlaceholderOptions as c, getImagePalette as d, getImagePlaceholderStyle as e, getImageSrcSet as f, getImageLqip as g, getImageUrl as h };

package/dist/{image-TT8lTsk5.d.ts → image-BDz2-AaO.d.ts}

@@ -79,4 +79,4 @@ interface ImagePlaceholderOptions {
  */
 declare function getImagePlaceholderStyle(image: ImageData, options?: ImagePlaceholderOptions): Record<string, string>;
 
-export { type ImageData as I, type ImagePalette as a, IMAGE_SIZES as b, getImageSrcSet as c, getImageLqip as d, getImagePalette as e, type ImagePlaceholderOptions as f, getImageUrl as g, getImagePlaceholderStyle as h };
+export { type ImageData as I, IMAGE_SIZES as a, type ImagePalette as b, type ImagePlaceholderOptions as c, getImagePalette as d, getImagePlaceholderStyle as e, getImageSrcSet as f, getImageLqip as g, getImageUrl as h };

package/dist/index.cjs

@@ -1260,6 +1260,7 @@ var INTERNAL_COLLECTIONS = [
   "analytics-event-schemas",
   "subscriptions",
   "billing-history",
+  "inventory-reservations",
   "order-status-logs",
   "api-keys",
   "personal-access-tokens",
@@ -1300,8 +1301,8 @@ var COLLECTIONS = [
   "carts",
   "cart-items",
   "discounts",
-  "promotions",
   "shipping-policies",
+  "shipping-zones",
   "documents",
   "document-categories",
   "document-types",
@@ -1343,8 +1344,6 @@ var COLLECTIONS = [
   "reaction-types",
   "bookmarks",
   "post-categories",
-  "reports",
-  "community-bans",
   // Events
   "event-calendars",
   "events",
@@ -1352,7 +1351,11 @@ var COLLECTIONS = [
   "event-occurrences",
   "event-tags"
 ];
-var SERVER_ONLY_COLLECTIONS = ["customer-groups"];
+var SERVER_ONLY_COLLECTIONS = [
+  "customer-groups",
+  "reports",
+  "community-bans"
+];
 var SERVER_COLLECTIONS = [
   ...COLLECTIONS,
   ...SERVER_ONLY_COLLECTIONS
@@ -1968,7 +1971,15 @@ var CommerceClient = class {
     };
     this.product = {
       stockCheck: (params) => execute("/api/products/stock-check", params),
-      listingGroups: (params) => execute("/api/products/listing-groups", params)
+      listingGroups: (params) => execute("/api/products/listing-groups", params),
+      detail: async (params) => {
+        try {
+          return await execute("/api/products/detail", params);
+        } catch (err) {
+          if (err instanceof NotFoundError) return null;
+          throw err;
+        }
+      }
     };
     this.cart = {
       get: cartApi.getCart.bind(cartApi),
@@ -2011,6 +2022,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
@@ -2047,6 +2084,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);
   }
@@ -2096,7 +2140,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),
@@ -2112,6 +2158,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),
@@ -2182,10 +2229,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) {
@@ -2343,6 +2404,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,
@@ -2363,6 +2427,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,
@@ -2379,6 +2446,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,
@@ -2531,7 +2601,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);
@@ -2548,6 +2618,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;
@@ -2641,6 +2712,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.ts
@@ -2703,7 +2789,8 @@ var Client = class {
     this.query = new QueryHooks(
       this.queryClient,
       collectionClient,
-      this.customer.auth
+      this.customer.auth,
+      this.commerce
     );
   }
   getState() {
@@ -2765,7 +2852,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 };