@01.software/sdk 0.36.0 → 0.37.0

package/dist/index.cjs

@@ -44,6 +44,7 @@ __export(src_exports, {
   NotFoundError: () => NotFoundError,
   ORDER_CHANGED_EVENT_TYPE: () => ORDER_CHANGED_EVENT_TYPE,
   OrderApi: () => OrderApi,
+  PRODUCT_PLP_FIND_OPTIONS: () => PRODUCT_PLP_FIND_OPTIONS,
   PRODUCT_UPSERT_READONLY_FIELD_REASON: () => PRODUCT_UPSERT_READONLY_FIELD_REASON,
   PRODUCT_UPSERT_UNKNOWN_FIELD_REASON: () => PRODUCT_UPSERT_UNKNOWN_FIELD_REASON,
   PermissionError: () => PermissionError,
@@ -69,6 +70,7 @@ __export(src_exports, {
   createAuthError: () => createAuthError,
   createClient: () => createClient2,
   createCommerceEmailWebhookHandler: () => createCommerceEmailWebhookHandler,
+  createCommerceNotificationWebhookHandler: () => createCommerceNotificationWebhookHandler,
   createConflictError: () => createConflictError,
   createCustomerAuthWebhookHandler: () => createCustomerAuthWebhookHandler,
   createNotFoundError: () => createNotFoundError,
@@ -945,13 +947,15 @@ var HttpClient = class {
 };
 
 // src/utils/types.ts
-var resolveRelation = (ref) => {
+function resolveRelation(ref) {
   if (typeof ref === "string" || typeof ref === "number" || ref === null || ref === void 0)
     return null;
   return ref;
-};
+}
 
 // src/core/metadata/index.ts
+var OPEN_GRAPH_IMAGE_SIZE = "1200";
+var LEGACY_OPEN_GRAPH_IMAGE_SIZE = "1536";
 function extractSeo(doc) {
   const seo = doc.seo ?? {};
   const og = seo.openGraph ?? {};
@@ -995,7 +999,7 @@ function generateMetadata(input, options) {
 function resolveMetaImage(ref) {
   const image = resolveRelation(ref);
   if (!image) return null;
-  const sized = image.sizes?.["1536"];
+  const sized = image.sizes?.[OPEN_GRAPH_IMAGE_SIZE] ?? image.sizes?.[LEGACY_OPEN_GRAPH_IMAGE_SIZE];
   const url = sized?.url || image.url;
   if (!url) return null;
   const width = sized?.url ? sized.width : image.width;
@@ -1127,13 +1131,16 @@ async function parseApiResponse(response, endpoint) {
   return data;
 }
 
-// src/core/community/community-client.ts
-var DEFAULT_POST_LIST_SORT = "-lastActivityAt";
-var DEFAULT_COMMENT_LIST_SORT = "-createdAt";
-var CommunityClient = class {
-  constructor(options) {
+// src/core/api/customer-scoped-api.ts
+var CustomerScopedApi = class {
+  constructor(apiName, options) {
+    if (options.requiresCredential !== false && !options.secretKey && !options.customerToken) {
+      throw createConfigError(
+        `Either secretKey or customerToken is required for ${apiName}.`
+      );
+    }
     this.publishableKey = requirePublishableKeyForSecret(
-      "CommunityClient",
+      apiName,
       options.publishableKey,
       options.secretKey
     );
@@ -1143,6 +1150,44 @@ var CommunityClient = class {
     this.onUnauthorized = options.onUnauthorized;
     this.onRequestId = options.onRequestId;
   }
+  async request(endpoint, options) {
+    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
+    try {
+      const response = await httpFetch(endpoint, {
+        method: options.method,
+        apiUrl: this.apiUrl,
+        publishableKey: this.publishableKey,
+        secretKey: this.secretKey,
+        customerToken: token ?? void 0,
+        ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
+        ...options.body !== void 0 && {
+          body: JSON.stringify(options.body)
+        },
+        ...options.headers && { headers: options.headers }
+      });
+      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
+      return parseApiResponse(response, endpoint);
+    } catch (err) {
+      const id = err instanceof SDKError ? err.requestId ?? null : null;
+      this.onRequestId?.(id);
+      throw err;
+    }
+  }
+};
+
+// src/core/community/community-client.ts
+var DEFAULT_POST_LIST_SORT = "-lastActivityAt";
+var DEFAULT_COMMENT_LIST_SORT = "-createdAt";
+function unwrapPayloadDoc(value) {
+  if (value && typeof value === "object" && "doc" in value) {
+    return value.doc;
+  }
+  return value;
+}
+var CommunityClient = class extends CustomerScopedApi {
+  constructor(options) {
+    super("CommunityClient", { ...options, requiresCredential: false });
+  }
   buildQuery(params) {
     if (!params) return "";
     const entries = Object.entries(params).filter((e) => e[1] !== void 0).map(([k, v]) => [k, String(v)]);
@@ -1183,27 +1228,14 @@ var CommunityClient = class {
     return `/api/comments?${urlParams.toString()}`;
   }
   async execute(endpoint, method, body) {
-    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
-    try {
-      const response = await httpFetch(endpoint, {
-        method,
-        apiUrl: this.apiUrl,
-        publishableKey: this.publishableKey,
-        secretKey: this.secretKey,
-        customerToken: token ?? void 0,
-        ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
-        ...body !== void 0 && { body: JSON.stringify(body) }
-      });
-      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return parseApiResponse(response, endpoint);
-    } catch (err) {
-      const id = err instanceof SDKError ? err.requestId ?? null : null;
-      this.onRequestId?.(id);
-      throw err;
-    }
+    return this.request(endpoint, { method, body });
+  }
+  async executeDoc(endpoint, method, body) {
+    const response = await this.execute(endpoint, method, body);
+    return unwrapPayloadDoc(response);
   }
   createPost(params) {
-    return this.execute("/api/posts", "POST", params);
+    return this.executeDoc("/api/posts", "POST", params);
   }
   /**
    * Public post feed. Server applies the same visibility contract as
@@ -1260,7 +1292,7 @@ var CommunityClient = class {
     if (parentId !== void 0) {
       body.parent = parentId;
     }
-    return this.execute("/api/comments", "POST", body);
+    return this.executeDoc("/api/comments", "POST", body);
   }
   /**
    * List comments for a post.
@@ -1298,7 +1330,7 @@ var CommunityClient = class {
   }
   updateComment(params) {
     const { commentId, body } = params;
-    return this.execute(
+    return this.executeDoc(
       `/api/comments/${commentId}`,
       "PATCH",
       { body }
@@ -1329,7 +1361,7 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
+    return this.executeDoc("/api/reactions", "POST", {
       post: postId,
       type: reactionType
     });
@@ -1351,7 +1383,7 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
+    return this.executeDoc("/api/reactions", "POST", {
       comment: commentId,
       type: reactionType
     });
@@ -1383,7 +1415,7 @@ var CommunityClient = class {
   }
   // Bookmarks
   addBookmark(params) {
-    return this.execute("/api/bookmarks", "POST", {
+    return this.executeDoc("/api/bookmarks", "POST", {
       post: params.postId
     });
   }
@@ -1634,43 +1666,12 @@ var CustomerNamespace = class {
 };
 
 // src/core/api/cart-api.ts
-var CartApi = class {
+var CartApi = class extends CustomerScopedApi {
   constructor(options) {
-    if (!options.secretKey && !options.customerToken) {
-      throw createConfigError(
-        "Either secretKey or customerToken is required for CartApi."
-      );
-    }
-    this.publishableKey = requirePublishableKeyForSecret(
-      "CartApi",
-      options.publishableKey,
-      options.secretKey
-    );
-    this.secretKey = options.secretKey;
-    this.apiUrl = options.apiUrl;
-    this.customerToken = options.customerToken;
-    this.onUnauthorized = options.onUnauthorized;
-    this.onRequestId = options.onRequestId;
+    super("CartApi", options);
   }
   async execute(endpoint, method, body) {
-    const token = typeof this.customerToken === "function" ? this.customerToken() : this.customerToken;
-    try {
-      const response = await httpFetch(endpoint, {
-        method,
-        apiUrl: this.apiUrl,
-        publishableKey: this.publishableKey,
-        secretKey: this.secretKey,
-        customerToken: token ?? void 0,
-        ...token && this.onUnauthorized && { onUnauthorized: this.onUnauthorized },
-        ...body !== void 0 && { body: JSON.stringify(body) }
-      });
-      this.onRequestId?.(response.headers.get("x-request-id") ?? null);
-      return parseApiResponse(response, endpoint);
-    } catch (err) {
-      const id = err instanceof SDKError ? err.requestId ?? null : null;
-      this.onRequestId?.(id);
-      throw err;
-    }
+    return this.request(endpoint, { method, body });
   }
   getCart(cartId) {
     return this.execute(`/api/carts/${cartId}`, "GET");
@@ -1894,15 +1895,24 @@ function splitIdempotencyKey(params) {
   const { idempotencyKey, ...body } = params;
   return { body, idempotencyKey };
 }
+function normalizeCreateOrderBody(params) {
+  if (params.items !== void 0) {
+    const { idempotencyKey: _idempotencyKey2, items, ...rest } = params;
+    return { ...rest, orderItems: items };
+  }
+  const { idempotencyKey: _idempotencyKey, ...body } = params;
+  return body;
+}
 var OrderApi = class extends BaseApi {
   constructor(options) {
     super("OrderApi", options);
   }
   createOrder(params) {
-    const { body, idempotencyKey } = splitIdempotencyKey(params);
+    const { idempotencyKey } = params;
+    const normalizedBody = normalizeCreateOrderBody(params);
     return this.request(
       "/api/orders/create",
-      body,
+      normalizedBody,
       idempotencyRequestOptions(idempotencyKey)
     );
   }
@@ -1964,6 +1974,12 @@ var OrderApi = class extends BaseApi {
       idempotencyRequestOptions(idempotencyKey)
     );
   }
+  prepareFulfillmentOrder(params) {
+    return this.request(
+      "/api/fulfillment-orders/prepare-fulfillment-order",
+      params
+    );
+  }
   updateFulfillment(params) {
     return this.request("/api/orders/update-fulfillment", params);
   }
@@ -1995,6 +2011,18 @@ var OrderApi = class extends BaseApi {
 };
 
 // src/core/commerce/commerce-client.ts
+var BrowserCommerceApi = class extends CustomerScopedApi {
+  post(endpoint, body, requestOptions) {
+    return this.request(endpoint, {
+      method: "POST",
+      body,
+      headers: requestOptions?.headers
+    });
+  }
+  get(endpoint) {
+    return this.request(endpoint, { method: "GET" });
+  }
+};
 var CommerceClient = class {
   constructor(options) {
     const cartApi = new CartApi({
@@ -2004,52 +2032,21 @@ var CommerceClient = class {
       onUnauthorized: options.onUnauthorized,
       onRequestId: options.onRequestId
     });
-    const execute = async (endpoint, body, requestOptions) => {
-      const token = options.customerToken();
-      try {
-        const response = await httpFetch(endpoint, {
-          method: "POST",
-          apiUrl: options.apiUrl,
-          publishableKey: options.publishableKey,
-          customerToken: token ?? void 0,
-          ...token && options.onUnauthorized && { onUnauthorized: options.onUnauthorized },
-          body: JSON.stringify(body),
-          ...requestOptions?.headers && { headers: requestOptions.headers }
-        });
-        options.onRequestId?.(response.headers.get("x-request-id") ?? null);
-        return parseApiResponse(response, endpoint);
-      } catch (err) {
-        const id = err instanceof SDKError ? err.requestId ?? null : null;
-        options.onRequestId?.(id);
-        throw err;
-      }
-    };
-    const executeGet = async (endpoint) => {
-      const token = options.customerToken();
-      try {
-        const response = await httpFetch(endpoint, {
-          method: "GET",
-          apiUrl: options.apiUrl,
-          publishableKey: options.publishableKey,
-          customerToken: token ?? void 0,
-          ...token && options.onUnauthorized && { onUnauthorized: options.onUnauthorized }
-        });
-        options.onRequestId?.(response.headers.get("x-request-id") ?? null);
-        return parseApiResponse(response, endpoint);
-      } catch (err) {
-        const id = err instanceof SDKError ? err.requestId ?? null : null;
-        options.onRequestId?.(id);
-        throw err;
-      }
-    };
+    const api = new BrowserCommerceApi("CommerceClient", {
+      publishableKey: options.publishableKey,
+      apiUrl: options.apiUrl,
+      customerToken: options.customerToken,
+      onUnauthorized: options.onUnauthorized,
+      onRequestId: options.onRequestId
+    });
     this.product = {
-      stockCheck: (params) => execute("/api/products/stock-check", params),
-      stockSnapshot: (params) => executeGet(stockSnapshotQuery(params)),
-      listingGroups: (params) => executeGet(listingGroupsQuery(params)),
-      listingGroupsCatalog: (params) => executeGet(listingGroupsCatalogQuery(params)),
+      stockCheck: (params) => api.post("/api/products/stock-check", params),
+      stockSnapshot: (params) => api.get(stockSnapshotQuery(params)),
+      listingGroups: (params) => api.get(listingGroupsQuery(params)),
+      listingGroupsCatalog: (params) => api.get(listingGroupsCatalogQuery(params)),
       detail: async (params) => {
         try {
-          const product = await executeGet(productDetailQuery(params));
+          const product = await api.get(productDetailQuery(params));
           return { found: true, product };
         } catch (err) {
           const notFoundResult = productDetailResultFromError(err);
@@ -2059,7 +2056,7 @@ var CommerceClient = class {
       },
       detailCatalog: async (params) => {
         try {
-          const product = await executeGet(
+          const product = await api.get(
             productDetailCatalogQuery(params)
           );
           return { found: true, product };
@@ -2082,7 +2079,7 @@ var CommerceClient = class {
     this.orders = {
       checkout: (params) => {
         const { body, idempotencyKey } = splitIdempotencyKey(params);
-        return execute(
+        return api.post(
           "/api/orders/checkout",
           body,
           idempotencyRequestOptions(idempotencyKey)
@@ -2091,10 +2088,10 @@ var CommerceClient = class {
       listMine: (params) => options.customerAuth.getMyOrders(params)
     };
     this.discounts = {
-      validate: (params) => execute("/api/discounts/validate", params)
+      validate: (params) => api.post("/api/discounts/validate", params)
     };
     this.shipping = {
-      calculate: (params) => execute("/api/shipping-policies/calculate", params)
+      calculate: (params) => api.post("/api/shipping-policies/calculate", params)
     };
   }
 };
@@ -2450,7 +2447,7 @@ function getCommerceNotificationIdempotencyKey(event) {
 function defineCommerceEmailConfig(config) {
   return config;
 }
-function createCommerceEmailWebhookHandler(handlers) {
+function createCommerceNotificationWebhookHandler(handlers) {
   return async (event) => {
     if (!isCommerceNotificationWebhookEvent(event)) {
       await handlers.unhandled?.(event);
@@ -2467,6 +2464,9 @@ function createCommerceEmailWebhookHandler(handlers) {
     });
   };
 }
+function createCommerceEmailWebhookHandler(handlers) {
+  return createCommerceNotificationWebhookHandler(handlers);
+}
 function isWebhookCollection(event, collection) {
   return isValidWebhookEvent(event) && event.collection === collection;
 }
@@ -2636,6 +2636,8 @@ var COLLECTIONS = [
   "order-items",
   "returns",
   "return-items",
+  "fulfillment-orders",
+  "fulfillment-order-items",
   "fulfillments",
   "fulfillment-items",
   "transactions",
@@ -4554,6 +4556,12 @@ function maxOfNullable(values) {
   const numbers = values.filter((v) => v !== null);
   return numbers.length === 0 ? null : Math.max(...numbers);
 }
+var PRODUCT_PLP_FIND_OPTIONS = {
+  joins: {
+    variants: { limit: 200, sort: "_order" },
+    options: { limit: 50, sort: "_order" }
+  }
+};
 function buildProductListingGroupsByOption(args) {
   const primaryOptionId = args.primaryOptionId ?? void 0;
   if (!primaryOptionId) return [];
@@ -4768,14 +4776,22 @@ function resolveProductGallery(input) {
 }
 
 // src/utils/image.ts
-var IMAGE_SIZES = [384, 768, 1536];
+var IMAGE_SIZES = [200, 400, 800, 1200, 1600];
+function imageSizeCandidates(sizes) {
+  const keys = new Set(IMAGE_SIZES);
+  for (const key of Object.keys(sizes)) {
+    const value = Number(key);
+    if (Number.isFinite(value) && value > 0) keys.add(value);
+  }
+  return [...keys].sort((a, b) => a - b);
+}
 function getImageUrl(image, displayWidth, dpr = 1) {
   const target = displayWidth * dpr;
   const sizes = image.sizes;
   if (sizes) {
-    for (const size of IMAGE_SIZES) {
+    for (const size of imageSizeCandidates(sizes)) {
       if (size >= target) {
-        const entry = sizes[String(size)];
+        const entry = sizes[`${size}`];
         if (entry?.url) return entry.url;
       }
     }
@@ -4784,16 +4800,18 @@ function getImageUrl(image, displayWidth, dpr = 1) {
 }
 function getImageSrcSet(image) {
   const parts = [];
+  const emittedWidths = /* @__PURE__ */ new Set();
   const sizes = image.sizes;
   if (sizes) {
-    for (const size of IMAGE_SIZES) {
-      const entry = sizes[String(size)];
-      if (entry?.url && entry.width) {
+    for (const size of imageSizeCandidates(sizes)) {
+      const entry = sizes[`${size}`];
+      if (entry?.url && entry.width && !emittedWidths.has(entry.width)) {
+        emittedWidths.add(entry.width);
         parts.push(`${entry.url} ${entry.width}w`);
       }
     }
   }
-  if (image.url && image.width) {
+  if (image.url && image.width && !emittedWidths.has(image.width)) {
     parts.push(`${image.url} ${image.width}w`);
   }
   return parts.join(", ");
@@ -4895,6 +4913,27 @@ function createAnalytics(config) {
     const nav = navigator;
     return nav.doNotTrack === "1" || nav.globalPrivacyControl === true;
   }
+  const isLocalHost = (() => {
+    try {
+      const h = location.hostname;
+      return h === "localhost" || h === "127.0.0.1" || h.endsWith(".local");
+    } catch {
+      return false;
+    }
+  })();
+  const mode = config.mode ?? "auto";
+  const sendSuppressed = mode === "development" || mode === "auto" && isLocalHost;
+  let suppressNoticeShown = false;
+  function devSuppressNotice() {
+    if (suppressNoticeShown) return;
+    suppressNoticeShown = true;
+    try {
+      console.info(
+        `[01 analytics] events disabled on local host (mode: '${mode}'). Pass mode: 'production' to send while developing.`
+      );
+    } catch {
+    }
+  }
   let lastPath = null;
   let lastAt = 0;
   const autoTrack = config.autoTrack !== false;
@@ -4925,6 +4964,10 @@ function createAnalytics(config) {
     if (isDntActive()) return;
     const doc = document;
     if (doc.prerendering === true || document.visibilityState === "prerender") return;
+    if (sendSuppressed) {
+      devSuppressNotice();
+      return;
+    }
     const now = Date.now();
     if (pathname === lastPath && now - lastAt < 500) return;
     lastPath = pathname;
@@ -4960,14 +5003,7 @@ function createAnalytics(config) {
       window.addEventListener("load", trackCurrentPath, { once: true });
     }
   }
-  const isProduction = (() => {
-    try {
-      const hostname = location.hostname;
-      return hostname !== "localhost" && hostname !== "127.0.0.1" && !hostname.endsWith(".local");
-    } catch {
-      return true;
-    }
-  })();
+  const isProduction = !isLocalHost;
   const warnedReasons = /* @__PURE__ */ new Set();
   function devWarn(name, reason) {
     if (isProduction) return;
@@ -5027,6 +5063,10 @@ function createAnalytics(config) {
           return;
         }
       }
+      if (sendSuppressed) {
+        devSuppressNotice();
+        return;
+      }
       const body = JSON.stringify({
         publishableKey: config.publishableKey,
         pathname: location.pathname,