@01.software/sdk 0.32.0 → 0.33.0

package/dist/server.d.cts

@@ -1,10 +1,10 @@
-import { S as ServerCollectionClient } from './collection-client-CORhppPb.cjs';
-export { C as CollectionClient } from './collection-client-CORhppPb.cjs';
-import { B as BaseApi, aQ as ServerApiOptions, aT as StockCheckParams, aU as StockCheckResponse, _ as ListingGroupsParams, as as ProductListingGroupsResponse, ad as ProductDetailParams, a4 as ProductDetail, bk as ProductDetailPreviewParams, bl as ProductDetailPreviewOptions, bm as ProductUpsertParams, bn as ProductUpsertResponse, k as AddItemParams, aX as UpdateItemParams, aL as RemoveItemParams, l as ApplyDiscountParams, aK as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, H as CreateOrderParams, aY as UpdateOrderParams, a$ as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, aW as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, I as CreateReturnParams, a_ as UpdateReturnParams, aP as ReturnWithRefundParams, b0 as ValidateDiscountParams, b1 as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bo as ClientServerConfig } from './types-CAkWqIr6.cjs';
-import { i as Cart, j as CartItem, O as Order, m as Transaction, n as Fulfillment, o as Return } from './payload-types-DVK1QCeU.cjs';
+import { S as ServerCollectionClient } from './collection-client-De6eKW1J.cjs';
+export { C as CollectionClient } from './collection-client-De6eKW1J.cjs';
+import { B as BaseApi, aU as ServerApiOptions, aX as StockCheckParams, aY as StockCheckResponse, _ as ListingGroupsParams, av as ProductListingGroupsResponse, ad as ProductDetailParams, ae as ProductDetailResult, bo as ProductDetailPreviewParams, bp as ProductDetailPreviewOptions, a4 as ProductDetail, bq as ProductUpsertParams, br as ProductUpsertResponse, k as AddItemParams, a$ as UpdateItemParams, aO as RemoveItemParams, l as ApplyDiscountParams, aN as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, H as CreateOrderParams, b0 as UpdateOrderParams, b3 as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, a_ as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, I as CreateReturnParams, b2 as UpdateReturnParams, aT as ReturnWithRefundParams, b4 as ValidateDiscountParams, b5 as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bs as ClientServerConfig } from './types-BZKxss8Y.cjs';
+import { i as Cart, j as CartItem, O as Order, m as Transaction, n as Fulfillment, o as Return } from './payload-types-dkeQyrDC.cjs';
 import './metadata.cjs';
-import './const-Brk2Ff0q.cjs';
-import './types-ByMrR_Z_.cjs';
+import './const-sPR2IkCe.cjs';
+import './types-B3YT092I.cjs';
 
 type ModerationApiOptions = ServerApiOptions;
 interface CommunityBan {
@@ -44,7 +44,7 @@ declare class ServerCommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
-        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
         previewDetail: (params: ProductDetailPreviewParams, options: ProductDetailPreviewOptions) => Promise<ProductDetail | null>;
         upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
     };

package/dist/server.d.ts

@@ -1,10 +1,10 @@
-import { S as ServerCollectionClient } from './collection-client-DPGXnhoF.js';
-export { C as CollectionClient } from './collection-client-DPGXnhoF.js';
-import { B as BaseApi, aQ as ServerApiOptions, aT as StockCheckParams, aU as StockCheckResponse, _ as ListingGroupsParams, as as ProductListingGroupsResponse, ad as ProductDetailParams, a4 as ProductDetail, bk as ProductDetailPreviewParams, bl as ProductDetailPreviewOptions, bm as ProductUpsertParams, bn as ProductUpsertResponse, k as AddItemParams, aX as UpdateItemParams, aL as RemoveItemParams, l as ApplyDiscountParams, aK as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, H as CreateOrderParams, aY as UpdateOrderParams, a$ as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, aW as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, I as CreateReturnParams, a_ as UpdateReturnParams, aP as ReturnWithRefundParams, b0 as ValidateDiscountParams, b1 as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bo as ClientServerConfig } from './types-CYMSBkJC.js';
-import { i as Cart, j as CartItem, O as Order, m as Transaction, n as Fulfillment, o as Return } from './payload-types-DVK1QCeU.js';
+import { S as ServerCollectionClient } from './collection-client-B6SlhzIP.js';
+export { C as CollectionClient } from './collection-client-B6SlhzIP.js';
+import { B as BaseApi, aU as ServerApiOptions, aX as StockCheckParams, aY as StockCheckResponse, _ as ListingGroupsParams, av as ProductListingGroupsResponse, ad as ProductDetailParams, ae as ProductDetailResult, bo as ProductDetailPreviewParams, bp as ProductDetailPreviewOptions, a4 as ProductDetail, bq as ProductUpsertParams, br as ProductUpsertResponse, k as AddItemParams, a$ as UpdateItemParams, aO as RemoveItemParams, l as ApplyDiscountParams, aN as RemoveDiscountParams, t as ClearCartParams, s as CheckoutParams, H as CreateOrderParams, b0 as UpdateOrderParams, b3 as UpdateTransactionParams, y as ConfirmPaymentParams, z as ConfirmPaymentResponse, F as CreateFulfillmentParams, a_ as UpdateFulfillmentParams, m as BulkImportFulfillmentsParams, n as BulkImportFulfillmentsResponse, I as CreateReturnParams, b2 as UpdateReturnParams, aT as ReturnWithRefundParams, b4 as ValidateDiscountParams, b5 as ValidateDiscountResult, o as CalculateShippingParams, p as CalculateShippingResult, a as CommunityClient, c as ClientState, bs as ClientServerConfig } from './types-BHh0YLmq.js';
+import { i as Cart, j as CartItem, O as Order, m as Transaction, n as Fulfillment, o as Return } from './payload-types-dkeQyrDC.js';
 import './metadata.js';
-import './const-DcY2_z9O.js';
-import './types-DUPC7Xn6.js';
+import './const-DwmSDeWq.js';
+import './types-Cel_4L9t.js';
 
 type ModerationApiOptions = ServerApiOptions;
 interface CommunityBan {
@@ -44,7 +44,7 @@ declare class ServerCommerceClient {
     readonly product: {
         stockCheck: (params: StockCheckParams) => Promise<StockCheckResponse>;
         listingGroups: (params: ListingGroupsParams) => Promise<ProductListingGroupsResponse>;
-        detail: (params: ProductDetailParams) => Promise<ProductDetail | null>;
+        detail: (params: ProductDetailParams) => Promise<ProductDetailResult>;
         previewDetail: (params: ProductDetailPreviewParams, options: ProductDetailPreviewOptions) => Promise<ProductDetail | null>;
         upsert: (params: ProductUpsertParams) => Promise<ProductUpsertResponse>;
     };

package/dist/server.js

@@ -1401,6 +1401,28 @@ var CartApi = class {
 };
 
 // src/core/api/product-api.ts
+var PRODUCT_DETAIL_UNAVAILABLE_REASONS = /* @__PURE__ */ new Set([
+  "not_found",
+  "not_published",
+  "feature_disabled"
+]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function readProductDetailUnavailableReason(value) {
+  if (!isRecord(value)) return void 0;
+  const directReason = value.reason ?? value.code;
+  if (typeof directReason === "string" && PRODUCT_DETAIL_UNAVAILABLE_REASONS.has(directReason)) {
+    return directReason;
+  }
+  return readProductDetailUnavailableReason(value.body);
+}
+function productDetailResultFromError(error) {
+  if (!(error instanceof SDKError) || error.status !== 404) return void 0;
+  const reason = readProductDetailUnavailableReason(error.details);
+  if (!reason) return void 0;
+  return { found: false, reason };
+}
 var ProductApi = class extends BaseApi {
   constructor(options) {
     super("ProductApi", options);
@@ -1421,15 +1443,24 @@ var ProductApi = class extends BaseApi {
   }
   /**
    * Fetch full product detail by slug or id.
-   * Returns `null` on 404 regardless of reason (`not_found` / `not_published` /
-   * `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.
    */
   async detail(params) {
     try {
-      return await this.request("/api/products/detail", params);
+      const product = await this.request(
+        "/api/products/detail",
+        params
+      );
+      return { found: true, product };
     } catch (err) {
-      if (err instanceof NotFoundError) return null;
+      const notFoundResult = productDetailResultFromError(err);
+      if (notFoundResult) return notFoundResult;
       throw err;
     }
   }
@@ -1496,7 +1527,7 @@ var OrderApi = class extends BaseApi {
   }
   bulkImportFulfillments(params) {
     return this.request(
-      "/api/orders/bulk-import-fulfillments",
+      "/api/fulfillments/bulk-import",
       params
     );
   }