@01.software/sdk 0.36.0 → 0.38.0

package/dist/index.js

@@ -807,70 +807,20 @@ 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
-function extractSeo(doc) {
-  const seo = doc.seo ?? {};
-  const og = seo.openGraph ?? {};
-  return {
-    title: seo.title ?? doc.title ?? null,
-    description: seo.description ?? null,
-    noIndex: seo.noIndex ?? null,
-    canonical: seo.canonical ?? null,
-    openGraph: {
-      title: og.title ?? null,
-      description: og.description ?? null,
-      image: og.image ?? null
-    }
-  };
-}
-function generateMetadata(input, options) {
-  const title = input.title ?? void 0;
-  const description = input.description ?? void 0;
-  const ogTitle = input.openGraph?.title ?? title;
-  const ogDescription = input.openGraph?.description ?? description;
-  const image = resolveMetaImage(input.openGraph?.image);
-  return {
-    title,
-    description,
-    ...input.noIndex && { robots: { index: false, follow: false } },
-    ...input.canonical && { alternates: { canonical: input.canonical } },
-    openGraph: {
-      ...ogTitle && { title: ogTitle },
-      ...ogDescription && { description: ogDescription },
-      ...options?.siteName && { siteName: options.siteName },
-      ...image && { images: [image] }
-    },
-    twitter: {
-      card: image ? "summary_large_image" : "summary",
-      ...ogTitle && { title: ogTitle },
-      ...ogDescription && { description: ogDescription },
-      ...image && { images: [image.url] }
-    }
-  };
 }
-function resolveMetaImage(ref) {
-  const image = resolveRelation(ref);
-  if (!image) return null;
-  const sized = image.sizes?.["1536"];
-  const url = sized?.url || image.url;
-  if (!url) return null;
-  const width = sized?.url ? sized.width : image.width;
-  const height = sized?.url ? sized.height : image.height;
+
+// src/core/collection/query-builder.ts
+function withDefaultPublicReadOptions(options) {
   return {
-    url,
-    ...width && { width },
-    ...height && { height },
-    ...image.alt && { alt: image.alt }
+    ...options,
+    depth: options?.depth ?? 0,
+    joins: options?.joins ?? false
   };
 }
-
-// src/core/collection/query-builder.ts
 var ReadOnlyCollectionQueryBuilder = class {
   constructor(api, collection) {
     this.api = api;
@@ -879,13 +829,13 @@ var ReadOnlyCollectionQueryBuilder = class {
   async find(options) {
     return this.api.requestFind(
       `/api/${String(this.collection)}`,
-      options
+      withDefaultPublicReadOptions(options)
     );
   }
   async findById(id, options) {
     return this.api.requestFindById(
       `/api/${String(this.collection)}/${String(id)}`,
-      options
+      withDefaultPublicReadOptions(options)
     );
   }
   async count(options) {
@@ -894,22 +844,6 @@ var ReadOnlyCollectionQueryBuilder = class {
       options
     );
   }
-  async findMetadata(options, metadataOptions) {
-    const { docs } = await this.find({ ...options, limit: 1, depth: 1 });
-    const doc = docs[0];
-    if (!doc) return null;
-    return generateMetadata(
-      extractSeo(doc),
-      metadataOptions
-    );
-  }
-  async findMetadataById(id, metadataOptions) {
-    const doc = await this.findById(id, { depth: 1 });
-    return generateMetadata(
-      extractSeo(doc),
-      metadataOptions
-    );
-  }
 };
 
 // src/core/collection/collection-client.ts
@@ -925,6 +859,21 @@ var ReadOnlyCollectionClient = class extends HttpClient {
     });
     return this.parseFindResponse(response);
   }
+  async requestFindEndpoint(endpoint, data) {
+    const response = await this.fetchWithTracking(endpoint, {
+      ...this.defaultOptions,
+      method: "POST",
+      body: data ? JSON.stringify(data) : void 0
+    });
+    return this.parseFindResponse(response);
+  }
+  async requestFindEndpointGet(endpoint) {
+    const response = await this.fetchWithTracking(endpoint, {
+      ...this.defaultOptions,
+      method: "GET"
+    });
+    return this.parseFindResponse(response);
+  }
   async requestFindById(endpoint, options) {
     const url = this.buildUrl(endpoint, options);
     const response = await this.fetchWithTracking(url, {
@@ -989,13 +938,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
     );
@@ -1005,6 +957,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)]);
@@ -1014,7 +1004,8 @@ var CommunityClient = class {
     const urlParams = new URLSearchParams();
     const sort = params?.sort ?? DEFAULT_POST_LIST_SORT;
     urlParams.set("sort", sort);
-    if (params?.limit !== void 0) urlParams.set("limit", String(params.limit));
+    if (params?.limit !== void 0)
+      urlParams.set("limit", String(params.limit));
     if (params?.page !== void 0) urlParams.set("page", String(params.page));
     if (params?.categoryId !== void 0) {
       urlParams.set("where[categories][in]", params.categoryId);
@@ -1022,7 +1013,7 @@ var CommunityClient = class {
     if (params?.tagId !== void 0) {
       urlParams.set("where[tags][in]", params.tagId);
     }
-    return `/api/posts?${urlParams.toString()}`;
+    return `/api/posts/public?${urlParams.toString()}`;
   }
   buildCommentsListQuery(params) {
     const urlParams = new URLSearchParams();
@@ -1042,30 +1033,21 @@ var CommunityClient = class {
     }
     if (params.limit !== void 0) urlParams.set("limit", String(params.limit));
     if (params.page !== void 0) urlParams.set("page", String(params.page));
-    return `/api/comments?${urlParams.toString()}`;
+    return `/api/comments/public?${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
@@ -1122,7 +1104,11 @@ 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.
@@ -1160,7 +1146,7 @@ var CommunityClient = class {
   }
   updateComment(params) {
     const { commentId, body } = params;
-    return this.execute(
+    return this.executeDoc(
       `/api/comments/${commentId}`,
       "PATCH",
       { body }
@@ -1191,10 +1177,14 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
-      post: postId,
-      type: reactionType
-    });
+    return this.executeDoc(
+      "/api/reactions",
+      "POST",
+      {
+        post: postId,
+        type: reactionType
+      }
+    );
   }
   removeReaction(params) {
     const { postId, type } = params;
@@ -1213,10 +1203,14 @@ var CommunityClient = class {
         400
       );
     }
-    return this.execute("/api/reactions", "POST", {
-      comment: commentId,
-      type: reactionType
-    });
+    return this.executeDoc(
+      "/api/reactions",
+      "POST",
+      {
+        comment: commentId,
+        type: reactionType
+      }
+    );
   }
   removeCommentReaction(params) {
     const { commentId, type } = params;
@@ -1245,9 +1239,13 @@ var CommunityClient = class {
   }
   // Bookmarks
   addBookmark(params) {
-    return this.execute("/api/bookmarks", "POST", {
-      post: params.postId
-    });
+    return this.executeDoc(
+      "/api/bookmarks",
+      "POST",
+      {
+        post: params.postId
+      }
+    );
   }
   removeBookmark(params) {
     return this.execute(
@@ -1263,10 +1261,7 @@ var CommunityClient = class {
   }
   // Profiles
   listProfileLists(params) {
-    return this.execute(
-      `/api/customer-profile-lists${this.buildQuery(params)}`,
-      "GET"
-    );
+    return this.execute(`/api/customer-profile-lists${this.buildQuery(params)}`, "GET");
   }
   async getProfileList(params) {
     const query = "slug" in params ? `?where[slug][equals]=${encodeURIComponent(params.slug)}&limit=1` : `?where[id][equals]=${encodeURIComponent(params.id)}&limit=1`;
@@ -1496,46 +1491,18 @@ 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");
+    return this.execute(
+      `/api/carts/${cartId}?depth=0&joins=false`,
+      "GET"
+    );
   }
   addItem(params) {
     return this.execute("/api/carts/add-item", "POST", params);
@@ -1756,15 +1723,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)
     );
   }
@@ -1826,6 +1802,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);
   }
@@ -1857,6 +1839,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({
@@ -1866,52 +1860,23 @@ 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);
@@ -1921,7 +1886,7 @@ var CommerceClient = class {
       },
       detailCatalog: async (params) => {
         try {
-          const product = await executeGet(
+          const product = await api.get(
             productDetailCatalogQuery(params)
           );
           return { found: true, product };
@@ -1944,7 +1909,7 @@ var CommerceClient = class {
     this.orders = {
       checkout: (params) => {
         const { body, idempotencyKey } = splitIdempotencyKey(params);
-        return execute(
+        return api.post(
           "/api/orders/checkout",
           body,
           idempotencyRequestOptions(idempotencyKey)
@@ -1953,10 +1918,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)
     };
   }
 };
@@ -2312,7 +2277,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);
@@ -2329,6 +2294,9 @@ function createCommerceEmailWebhookHandler(handlers) {
     });
   };
 }
+function createCommerceEmailWebhookHandler(handlers) {
+  return createCommerceNotificationWebhookHandler(handlers);
+}
 function isWebhookCollection(event, collection) {
   return isValidWebhookEvent(event) && event.collection === collection;
 }
@@ -2466,6 +2434,7 @@ var INTERNAL_COLLECTIONS = [
   "subscriptions",
   "billing-history",
   "inventory-reservations",
+  "inventory-adjustments",
   "commerce-notification-intents",
   "product-collection-items",
   "order-status-logs",
@@ -2484,7 +2453,6 @@ var INTERNAL_COLLECTIONS = [
 var COLLECTIONS = [
   "tenants",
   "tenant-metadata",
-  "tenant-logos",
   "products",
   "product-variants",
   "product-options",
@@ -2493,19 +2461,7 @@ var COLLECTIONS = [
   "product-tags",
   "product-collections",
   "brands",
-  "brand-logos",
-  "orders",
-  "order-items",
-  "returns",
-  "return-items",
-  "fulfillments",
-  "fulfillment-items",
-  "transactions",
-  "customers",
   "customer-profiles",
-  "customer-addresses",
-  "carts",
-  "cart-items",
   "discounts",
   "shipping-policies",
   "shipping-zones",
@@ -2536,19 +2492,11 @@ var COLLECTIONS = [
   "canvas-tags",
   "canvas-nodes",
   "canvas-edges",
-  "videos",
   "video-categories",
   "video-tags",
-  "live-streams",
-  "images",
   "forms",
-  "form-submissions",
   // Community
-  "posts",
-  "comments",
-  "reactions",
   "reaction-types",
-  "bookmarks",
   "post-categories",
   "post-tags",
   "customer-profile-lists",
@@ -2560,9 +2508,33 @@ var COLLECTIONS = [
   "event-tags"
 ];
 var SERVER_ONLY_COLLECTIONS = [
+  "tenant-logos",
+  "brand-logos",
+  "images",
+  "videos",
+  "orders",
+  "order-items",
+  "returns",
+  "return-items",
+  "fulfillment-orders",
+  "fulfillment-order-items",
+  "fulfillments",
+  "fulfillment-items",
+  "transactions",
+  "customers",
+  "customer-addresses",
+  "form-submissions",
+  "carts",
+  "cart-items",
+  "posts",
+  "comments",
+  "reactions",
+  "bookmarks",
+  "live-streams",
   "customer-groups",
   "reports",
-  "community-bans"
+  "community-bans",
+  "order-export-profiles"
 ];
 var SERVER_COLLECTIONS = [
   ...COLLECTIONS,
@@ -4416,6 +4388,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 [];
@@ -4609,8 +4587,6 @@ function resolveLegacyMediaSet(input) {
   };
 }
 function resolveProductGallery(input) {
-  const legacyResolved = resolveLegacyMediaSet(input);
-  if (legacyResolved && legacyResolved.source !== "none") return legacyResolved;
   const selectedVariantId = mediaId(input.selectedVariantId);
   const selectedOptionValueIds = relationshipIds(input.selectedOptionValueIds);
   const selection = resolveProductSelectionMedia({
@@ -4622,6 +4598,8 @@ function resolveProductGallery(input) {
   if (selection.source !== "none") {
     return selection;
   }
+  const legacyResolved = resolveLegacyMediaSet(input);
+  if (legacyResolved && legacyResolved.source !== "none") return legacyResolved;
   return resolveProductDisplayMedia({
     productMediaPool: input.productMediaPool ?? input.pool ?? null,
     productPrimaryMediaItemId: input.productPrimaryMediaItemId,
@@ -4630,14 +4608,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;
       }
     }
@@ -4646,16 +4632,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(", ");
@@ -4757,6 +4745,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;
@@ -4787,6 +4796,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;
@@ -4822,14 +4835,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;
@@ -4889,6 +4895,10 @@ function createAnalytics(config) {
           return;
         }
       }
+      if (sendSuppressed) {
+        devSuppressNotice();
+        return;
+      }
       const body = JSON.stringify({
         publishableKey: config.publishableKey,
         pathname: location.pathname,
@@ -4943,6 +4953,7 @@ export {
   NotFoundError,
   ORDER_CHANGED_EVENT_TYPE,
   OrderApi,
+  PRODUCT_PLP_FIND_OPTIONS,
   PRODUCT_UPSERT_READONLY_FIELD_REASON,
   PRODUCT_UPSERT_UNKNOWN_FIELD_REASON,
   PermissionError,
@@ -4968,6 +4979,7 @@ export {
   createAuthError,
   createClient2 as createClient,
   createCommerceEmailWebhookHandler,
+  createCommerceNotificationWebhookHandler,
   createConflictError,
   createCustomerAuthWebhookHandler,
   createNotFoundError,