@01.software/sdk 0.39.0 → 0.40.0

package/dist/{collection-client-CaMgs5KE.d.ts → collection-client-CKFa99C6.d.ts}

@@ -1,7 +1,7 @@
-import { D as DebugConfig, x as RetryConfig, f as ApiQueryOptions, P as PayloadFindResponse, n as PayloadMutationResponse, ax as PublicReadQueryOptions } from './types-CVf8sCZ-.js';
+import { D as DebugConfig, x as RetryConfig, f as ApiQueryOptions, P as PayloadFindResponse, n as PayloadMutationResponse, ax as PublicReadQueryOptions } from './types-Umd-YTjM.js';
 import { GenerateMetadataOptions, Metadata } from './metadata.js';
-import { S as ServerCollection, P as PublicCollection } from './const-6XHz_jej.js';
-import { C as CollectionType } from './types-Cmrd1ezc.js';
+import { S as ServerCollection, P as PublicCollection } from './const-ymprfiPf.js';
+import { C as CollectionType } from './types-Bh2p-EMc.js';
 
 interface FetchOptions extends RequestInit {
     apiUrl?: string;

package/dist/{collection-client-DVfB0Em1.d.cts → collection-client-VYwYi6u6.d.cts}

@@ -1,7 +1,7 @@
-import { D as DebugConfig, x as RetryConfig, f as ApiQueryOptions, P as PayloadFindResponse, n as PayloadMutationResponse, ax as PublicReadQueryOptions } from './types-BQo7UdI9.cjs';
+import { D as DebugConfig, x as RetryConfig, f as ApiQueryOptions, P as PayloadFindResponse, n as PayloadMutationResponse, ax as PublicReadQueryOptions } from './types-D5uHrPLr.cjs';
 import { GenerateMetadataOptions, Metadata } from './metadata.cjs';
-import { S as ServerCollection, P as PublicCollection } from './const-B5KT72c7.cjs';
-import { C as CollectionType } from './types-D0ubzQw0.cjs';
+import { S as ServerCollection, P as PublicCollection } from './const-4BUtUdGU.cjs';
+import { C as CollectionType } from './types-BvpjooU-.cjs';
 
 interface FetchOptions extends RequestInit {
     apiUrl?: string;

package/dist/const-4BUtUdGU.d.cts

@@ -0,0 +1,32 @@
+import { d as Config } from './payload-types-DC0xzR9i.cjs';
+
+/**
+ * Collection type derived from Payload Config.
+ * This ensures type safety and automatic synchronization with payload-types.ts
+ */
+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", "inventory-reservations", "inventory-adjustments", "commerce-notification-intents", "product-collection-items", "order-status-logs", "tenant-commerce-config", "api-keys", "personal-access-tokens", "tenant-entitlements", "tenant-purge-jobs", "direct-upload-sessions", "webhook-events", "webhook-deliveries", "audit-logs", "plans", "webhooks", "event-registrations"];
+/**
+ * Array of browser-public collection names for runtime use (e.g., Zod enum validation).
+ * This is the single source of truth for publishable-key collection discovery.
+ */
+declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "customer-profiles", "customer-profile-stats", "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", "video-categories", "video-tags", "forms", "reaction-types", "post-categories", "post-tags", "customer-profile-lists", "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 ["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", "checkouts", "checkout-items", "posts", "comments", "reactions", "bookmarks", "live-streams", "canvas-nodes", "canvas-edges", "customer-groups", "reports", "community-bans", "order-export-profiles"];
+/**
+ * Browser-public collections available for publishable-key SDK access.
+ * Derived from the COLLECTIONS array (single source of truth).
+ */
+type PublicCollection = (typeof COLLECTIONS)[number];
+declare const SERVER_COLLECTIONS: readonly ["tenants", "tenant-metadata", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "customer-profiles", "customer-profile-stats", "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", "video-categories", "video-tags", "forms", "reaction-types", "post-categories", "post-tags", "customer-profile-lists", "event-calendars", "events", "event-categories", "event-occurrences", "event-tags", "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", "checkouts", "checkout-items", "posts", "comments", "reactions", "bookmarks", "live-streams", "canvas-nodes", "canvas-edges", "customer-groups", "reports", "community-bans", "order-export-profiles"];
+type ServerCollection = (typeof SERVER_COLLECTIONS)[number];
+
+export { type Collection as C, INTERNAL_COLLECTIONS as I, type PublicCollection as P, type ServerCollection as S, COLLECTIONS as a, SERVER_COLLECTIONS as b, SERVER_ONLY_COLLECTIONS as c };

package/dist/const-ymprfiPf.d.ts

@@ -0,0 +1,32 @@
+import { d as Config } from './payload-types-DC0xzR9i.js';
+
+/**
+ * Collection type derived from Payload Config.
+ * This ensures type safety and automatic synchronization with payload-types.ts
+ */
+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", "inventory-reservations", "inventory-adjustments", "commerce-notification-intents", "product-collection-items", "order-status-logs", "tenant-commerce-config", "api-keys", "personal-access-tokens", "tenant-entitlements", "tenant-purge-jobs", "direct-upload-sessions", "webhook-events", "webhook-deliveries", "audit-logs", "plans", "webhooks", "event-registrations"];
+/**
+ * Array of browser-public collection names for runtime use (e.g., Zod enum validation).
+ * This is the single source of truth for publishable-key collection discovery.
+ */
+declare const COLLECTIONS: readonly ["tenants", "tenant-metadata", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "customer-profiles", "customer-profile-stats", "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", "video-categories", "video-tags", "forms", "reaction-types", "post-categories", "post-tags", "customer-profile-lists", "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 ["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", "checkouts", "checkout-items", "posts", "comments", "reactions", "bookmarks", "live-streams", "canvas-nodes", "canvas-edges", "customer-groups", "reports", "community-bans", "order-export-profiles"];
+/**
+ * Browser-public collections available for publishable-key SDK access.
+ * Derived from the COLLECTIONS array (single source of truth).
+ */
+type PublicCollection = (typeof COLLECTIONS)[number];
+declare const SERVER_COLLECTIONS: readonly ["tenants", "tenant-metadata", "products", "product-variants", "product-options", "product-option-values", "product-categories", "product-tags", "product-collections", "brands", "customer-profiles", "customer-profile-stats", "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", "video-categories", "video-tags", "forms", "reaction-types", "post-categories", "post-tags", "customer-profile-lists", "event-calendars", "events", "event-categories", "event-occurrences", "event-tags", "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", "checkouts", "checkout-items", "posts", "comments", "reactions", "bookmarks", "live-streams", "canvas-nodes", "canvas-edges", "customer-groups", "reports", "community-bans", "order-export-profiles"];
+type ServerCollection = (typeof SERVER_COLLECTIONS)[number];
+
+export { type Collection as C, INTERNAL_COLLECTIONS as I, type PublicCollection as P, type ServerCollection as S, COLLECTIONS as a, SERVER_COLLECTIONS as b, SERVER_ONLY_COLLECTIONS as c };

package/dist/{index-BOLQxveo.d.cts → index-Dquv4xTL.d.cts}

@@ -1,6 +1,6 @@
-import { C as Collection } from './const-B5KT72c7.cjs';
-import { C as CollectionType } from './types-D0ubzQw0.cjs';
-import './payload-types-m3jjhxk9.cjs';
+import { C as Collection } from './const-4BUtUdGU.cjs';
+import { C as CollectionType } from './types-BvpjooU-.cjs';
+import './payload-types-DC0xzR9i.cjs';
 
 type WebhookOperation = string;
 /**

package/dist/{index-CSwR2HSg.d.ts → index-w36lpSkU.d.ts}

@@ -1,6 +1,6 @@
-import { C as Collection } from './const-6XHz_jej.js';
-import { C as CollectionType } from './types-Cmrd1ezc.js';
-import './payload-types-m3jjhxk9.js';
+import { C as Collection } from './const-ymprfiPf.js';
+import { C as CollectionType } from './types-Bh2p-EMc.js';
+import './payload-types-DC0xzR9i.js';
 
 type WebhookOperation = string;
 /**

package/dist/index.cjs

@@ -63,8 +63,8 @@ __export(src_exports, {
   ValidationError: () => ValidationError,
   buildProductHref: () => buildProductHref,
   buildProductListingCard: () => buildProductListingCard,
+  buildProductListingGroupProjection: () => buildProductListingGroupProjection,
   buildProductListingGroupsByOption: () => buildProductListingGroupsByOption,
-  buildProductListingProjection: () => buildProductListingProjection,
   buildProductOptionMatrix: () => buildProductOptionMatrix,
   buildProductOptionMatrixFromDetail: () => buildProductOptionMatrixFromDetail,
   createAnalytics: () => createAnalytics,
@@ -123,7 +123,7 @@ __export(src_exports, {
   normalizeProductSelectionFromMatrix: () => normalizeProductSelectionFromMatrix,
   normalizeSelectedValueIds: () => normalizeSelectedValueIds,
   parseProductSelection: () => parseProductSelection,
-  resolveListingPrimaryImagePointer: () => resolveListingPrimaryImagePointer,
+  resolveFeaturedImagePointer: () => resolveFeaturedImagePointer,
   resolveProductDisplayMedia: () => resolveProductDisplayMedia,
   resolveProductGallery: () => resolveProductGallery,
   resolveProductMedia: () => resolveProductMedia,
@@ -1667,6 +1667,19 @@ var CustomerAuth = class {
     const params = new URLSearchParams();
     if (options?.page) params.set("page", String(options.page));
     if (options?.limit) params.set("limit", String(options.limit));
+    if (options?.displayFinancialStatus) {
+      params.set("displayFinancialStatus", options.displayFinancialStatus);
+    }
+    if (options?.displayFulfillmentStatus) {
+      params.set("displayFulfillmentStatus", options.displayFulfillmentStatus);
+    }
+    if (options?.returnStatus) params.set("returnStatus", options.returnStatus);
+    if (options?.primaryDisplayStatus) {
+      params.set("primaryDisplayStatus", options.primaryDisplayStatus);
+    }
+    if (options?.returnDisplayStatus) {
+      params.set("returnDisplayStatus", options.returnDisplayStatus);
+    }
     if (options?.status) params.set("status", options.status);
     const qs = params.toString();
     return this.requestJson(`/api/customers/me/orders${qs ? `?${qs}` : ""}`, {
@@ -1939,25 +1952,14 @@ function resolveProductSelectionMedia(input) {
 function resolveProductDisplayMedia(input) {
   const pool = mediaArray(input.productMediaPool);
   const poolById = buildPoolById(pool);
-  const listingPointer = toPointerId(input.listingPrimaryImage);
-  if (listingPointer) {
-    const listingPrimary = poolById.get(listingPointer);
-    if (listingPrimary) {
+  const featuredImagePointer = toPointerId(input.featuredImage);
+  if (featuredImagePointer) {
+    const featuredImage = poolById.get(featuredImagePointer);
+    if (featuredImage) {
       return {
-        primaryImage: listingPrimary,
-        images: uniqueWithPrimaryFirst(listingPrimary, pool),
-        source: "listing_primary"
-      };
-    }
-  }
-  const productPrimaryPointer = getMediaId(input.productPrimaryMediaItemId);
-  if (productPrimaryPointer) {
-    const productPrimary = poolById.get(productPrimaryPointer);
-    if (productPrimary) {
-      return {
-        primaryImage: productPrimary,
-        images: uniqueWithPrimaryFirst(productPrimary, pool),
-        source: "product_primary"
+        primaryImage: featuredImage,
+        images: uniqueWithPrimaryFirst(featuredImage, pool),
+        source: "featured_image"
       };
     }
   }
@@ -1977,22 +1979,16 @@ function resolveProductDisplayMedia(input) {
     source: "none"
   };
 }
-function resolveListingPrimaryImagePointer(input) {
+function resolveFeaturedImagePointer(input) {
   const pool = mediaArray(input.productMediaPool);
   const resolvedPointer = getMediaId(input.resolvedPrimary);
   if (resolvedPointer && input.resolvedSource !== "product_pool" && input.resolvedSource !== "none") {
     return resolvedPointer;
   }
   const poolById = buildPoolById(pool);
-  const listingPointer = getMediaId(input.listingPrimaryImage);
-  if (listingPointer && poolById.has(listingPointer)) {
-    return listingPointer;
-  }
-  const primaryPointer = toPointerId(input.productPrimaryMediaItemId);
-  if (primaryPointer && poolById.has(primaryPointer)) return primaryPointer;
-  const thumbnailPointer = getMediaId(input.productThumbnail);
-  if (thumbnailPointer && poolById.has(thumbnailPointer)) {
-    return thumbnailPointer;
+  const featuredImagePointer = getMediaId(input.featuredImage);
+  if (featuredImagePointer && poolById.has(featuredImagePointer)) {
+    return featuredImagePointer;
   }
   if (pool.length > 0) {
     const firstPoolId = getMediaId(pool[0]);
@@ -2071,18 +2067,22 @@ function getFirstMediaId(values) {
   }
   return null;
 }
+function inProductMediaPool(product, mediaId2) {
+  if (mediaId2 == null) return null;
+  const images = Array.isArray(product?.images) ? product.images : [];
+  for (const image of images) {
+    if (extractEntityId(image) === mediaId2) return mediaId2;
+  }
+  return null;
+}
 function getVariantPrimaryImage(variant) {
   if (!variant) return null;
   return extractEntityId(variant.thumbnail) ?? getFirstMediaId(variant.images);
 }
 function resolveGenericListingPrimaryImage(product, resolvedPrimary, resolvedSource) {
-  return resolveListingPrimaryImagePointer({
+  return resolveFeaturedImagePointer({
     productMediaPool: product?.images ?? [],
-    productPrimaryMediaItemId: getRelationID(
-      product?.primaryMediaItemId ?? null
-    ),
-    productThumbnail: product?.thumbnail ?? null,
-    listingPrimaryImage: product?.listing?.primaryImage ?? null,
+    featuredImage: product?.featuredImage ?? null,
     resolvedPrimary,
     resolvedSource
   });
@@ -2735,7 +2735,7 @@ function normalizedSelectionFromByOptionId(matrix, selectedByOptionId, variantId
     variantId
   };
 }
-function buildFilledNormalizedSelection(matrix, normalizedSelection, listing) {
+function buildFilledNormalizedSelection(matrix, normalizedSelection, selectionHintVariant) {
   const selectedByOptionId = new Map(
     Object.entries(normalizedSelection.byOptionId)
   );
@@ -2776,7 +2776,7 @@ function buildFilledNormalizedSelection(matrix, normalizedSelection, listing) {
   const orderedMatches = [...matchingVariantEntries].sort(
     (left, right) => compareVariantOrder(left.source, right.source)
   );
-  const hintVariantId = listing.selectionHintVariant != null ? String(listing.selectionHintVariant) : null;
+  const hintVariantId = selectionHintVariant != null ? String(selectionHintVariant) : null;
   const hintedEntry = hintVariantId != null ? orderedMatches.find((entry) => entry.id === hintVariantId) : void 0;
   const availableEntry = orderedMatches.find(
     (entry) => isVariantAvailableForSale(entry.source)
@@ -2835,7 +2835,6 @@ function buildSelectionMedia(detail, selectedVariant, matchingVariants, selected
   const productPool = mediaArray2(detail.images);
   const resolvedMedia = resolveProductSelectionMedia({
     productMediaPool: productPool,
-    productPrimaryMediaItemId: getRelationID(detail.primaryMediaItemId),
     selectedVariant: selectedVariant ? {
       id: selectedVariant.id,
       images: selectedVariant.images
@@ -2858,8 +2857,7 @@ function buildSelectionMedia(detail, selectedVariant, matchingVariants, selected
   }
   const displayMedia = resolveProductDisplayMedia({
     productMediaPool: productPool,
-    productPrimaryMediaItemId: getRelationID(detail.primaryMediaItemId),
-    listingPrimaryImage: detail.listing.primaryImage ?? null
+    featuredImage: detail.featuredImage ?? null
   });
   if (displayMedia.source !== "none") {
     return {
@@ -2929,14 +2927,15 @@ function getCandidateVariantsForValue(matrix, optionId, valueId, selectedValueId
 }
 function getResolutionContext(context) {
   return {
+    featuredImage: context?.featuredImage ?? context?.detail?.featuredImage,
     images: context?.images ?? context?.detail?.images ?? [],
-    listing: context?.listing ?? context?.detail?.listing ?? {},
-    primaryMediaItemId: context?.primaryMediaItemId ?? context?.detail?.primaryMediaItemId ?? null
+    selectedOrFirstAvailableVariant: context?.selectedOrFirstAvailableVariant ?? context?.detail?.selectedOrFirstAvailableVariant
   };
 }
 function resolveProductSelectionFromMatrix(matrix, selection = {}, options, context) {
-  const { images, listing, primaryMediaItemId } = getResolutionContext(context);
-  const effectiveSelection = hasExplicitSelection(selection) || listing.selectionHintVariant == null ? selection : { ...selection, variantId: listing.selectionHintVariant };
+  const { featuredImage, images, selectedOrFirstAvailableVariant } = getResolutionContext(context);
+  const selectionHintVariant = getRelationID(selectedOrFirstAvailableVariant);
+  const effectiveSelection = hasExplicitSelection(selection) || selectionHintVariant == null ? selection : { ...selection, variantId: selectionHintVariant };
   let normalizedSelection = normalizeProductSelectionFromMatrix(
     matrix,
     effectiveSelection,
@@ -2946,7 +2945,7 @@ function resolveProductSelectionFromMatrix(matrix, selection = {}, options, cont
     normalizedSelection = buildFilledNormalizedSelection(
       matrix,
       normalizedSelection,
-      listing
+      selectionHintVariant
     );
   }
   const matchingVariantEntries = getMatchingVariantEntries(
@@ -3017,11 +3016,8 @@ function resolveProductSelectionFromMatrix(matrix, selection = {}, options, cont
     price: buildSelectionPrice(priceVariants),
     media: buildSelectionMedia(
       {
-        images,
-        listing: {
-          primaryImage: listing.primaryImage ?? null
-        },
-        primaryMediaItemId
+        featuredImage,
+        images
       },
       selectedVariant,
       matchingVariants,
@@ -3038,7 +3034,9 @@ function resolveProductSelection(detail, selection = {}, options) {
 }
 function selectNext(detail, current = {}, optionSlug, valueSlug, options) {
   const matrix = buildProductOptionMatrixFromDetail(detail);
-  const listing = detail.listing ?? {};
+  const selectionHintVariant = getRelationID(
+    detail.selectedOrFirstAvailableVariant
+  );
   const normalizedCurrent = normalizeProductSelectionFromMatrix(
     matrix,
     current,
@@ -3074,7 +3072,7 @@ function selectNext(detail, current = {}, optionSlug, valueSlug, options) {
     return buildFilledNormalizedSelection(
       matrix,
       normalizedSelectionFromByOptionId(matrix, selectedByOptionId, null),
-      listing
+      selectionHintVariant
     );
   };
   const keepPriorSelection = () => {
@@ -3085,7 +3083,7 @@ function selectNext(detail, current = {}, optionSlug, valueSlug, options) {
     return buildFilledNormalizedSelection(
       matrix,
       normalizedSelectionFromByOptionId(matrix, selectedByOptionId, null),
-      listing
+      selectionHintVariant
     );
   };
   const clickedResult = keepClickedSelection();
@@ -3295,7 +3293,7 @@ function getMinMax(values) {
     max: Math.max(...numbers)
   };
 }
-function buildProductListingProjection(product, variants) {
+function buildProductListingGroupProjection(product, variants) {
   const orderedVariants = [...variants].sort(compareVariantOrder);
   const activeVariants = orderedVariants.filter(
     (variant) => variant.isActive !== false
@@ -3316,7 +3314,6 @@ function buildProductListingProjection(product, variants) {
   const mediaSelectionVariants = sortVariantsForMediaSelection(variants);
   const resolvedProductMedia = resolveProductSelectionMedia({
     productMediaPool,
-    productPrimaryMediaItemId: getRelationID(product?.primaryMediaItemId),
     selectedVariant: selectionHintVariant && selectionHintHasPoolMedia ? {
       id: selectionHintVariant.id,
       images: selectionHintVariant.images
@@ -3342,47 +3339,22 @@ function buildProductListingCard(item, options = {}) {
   const product = item.product;
   const groups = item.groups;
   const variants = getProductListingCardVariants(item);
-  const projectedListing = buildProductListingProjection(product, variants);
-  const selectionHintVariant = getRelationID(
-    product.listing && "selectionHintVariant" in product.listing ? product.listing.selectionHintVariant : null
-  ) ?? projectedListing.selectionHintVariant;
+  const projectedListing = buildProductListingGroupProjection(product, variants);
+  const selectionHintVariant = getRelationID(product.selectedOrFirstAvailableVariant) ?? projectedListing.selectionHintVariant;
   const representativeVariant = findListingCardRepresentativeVariant(
     variants,
     selectionHintVariant
   );
   const productMediaPool = mediaArray2(product.images);
-  const representativeHasPoolMedia = Boolean(
-    representativeVariant?.images?.some(
-      (image) => productMediaPool.some(
-        (poolItem) => getRelationID(poolItem) === getRelationID(image)
-      )
-    )
-  );
-  const resolvedPrimaryMedia = resolveProductSelectionMedia(
-    {
-      productMediaPool,
-      productPrimaryMediaItemId: getRelationID(product.primaryMediaItemId),
-      selectedVariant: representativeHasPoolMedia ? representativeVariant : null,
-      matchingVariants: representativeHasPoolMedia ? [] : variants
-    }
-  );
-  const listingPrimaryPointer = resolveListingPrimaryImagePointer({
-    productMediaPool,
-    productPrimaryMediaItemId: getRelationID(product.primaryMediaItemId),
-    productThumbnail: product.thumbnail ?? null,
-    listingPrimaryImage: product.listing?.primaryImage ?? null,
-    resolvedPrimary: resolvedPrimaryMedia.primaryImage,
-    resolvedSource: resolvedPrimaryMedia.source
-  });
-  const listingPrimaryMedia = listingPrimaryPointer ? productMediaPool.find(
-    (item2) => getRelationID(item2) === listingPrimaryPointer
-  ) ?? resolvedPrimaryMedia.primaryImage ?? null : null;
+  const featuredImageId = getRelationID(product.featuredImage);
+  const featuredImageFromPool = featuredImageId ? productMediaPool.find((item2) => getRelationID(item2) === featuredImageId) : void 0;
+  const listingPrimaryMedia = featuredImageFromPool ?? product.featuredImage ?? productMediaPool[0] ?? null;
   const priceRange = resolveListingCardPriceRange(
     product,
     projectedListing,
     groups
   );
-  const availableForSale = product.listing?.availableForSale != null ? product.listing.availableForSale : groups.length > 0 ? groups.some((group) => group.listing.availableForSale) : projectedListing.availableForSale;
+  const availableForSale = product.availableForSale != null ? product.availableForSale : groups.length > 0 ? groups.some((group) => group.listing.availableForSale) : projectedListing.availableForSale;
   const swatches = groups.length > 1 ? groups.map((group) => buildListingSwatch(product, group, options)) : [];
   return {
     id: String(product.id),
@@ -3428,23 +3400,20 @@ function toShopifyPriceRangeV2(listing) {
     maxVariantPrice: { amount: listing.maxPrice ?? null }
   };
 }
-function hasCompleteListingPriceProjection(listing) {
-  return listing?.minPrice != null && listing?.maxPrice != null;
-}
-function listingDefinesCompareAtProjection(listing) {
-  return "minCompareAtPrice" in listing || "maxCompareAtPrice" in listing;
+function hasCompleteProductPriceRange(priceRange) {
+  return priceRange?.minVariantPrice?.amount != null && priceRange?.maxVariantPrice?.amount != null;
 }
 function resolveListingCardPriceRange(product, projectedListing, groups) {
-  const listing = product.listing;
-  if (hasCompleteListingPriceProjection(listing)) {
+  if (hasCompleteProductPriceRange(product.priceRange)) {
     const groupRange = groups.length > 0 ? aggregateListingPriceRange(groups) : null;
-    const definesCompareAt = listingDefinesCompareAtProjection(listing);
+    const minCompareAtPrice = product.compareAtPriceRange?.minVariantPrice?.amount ?? groupRange?.minCompareAtPrice ?? null;
+    const maxCompareAtPrice = product.compareAtPriceRange?.maxVariantPrice?.amount ?? groupRange?.maxCompareAtPrice ?? null;
     return {
-      minPrice: listing.minPrice,
-      maxPrice: listing.maxPrice,
-      minCompareAtPrice: definesCompareAt ? listing.minCompareAtPrice ?? null : groupRange?.minCompareAtPrice ?? projectedListing.minCompareAtPrice,
-      maxCompareAtPrice: definesCompareAt ? listing.maxCompareAtPrice ?? null : groupRange?.maxCompareAtPrice ?? projectedListing.maxCompareAtPrice,
-      isPriceRange: listing.isPriceRange ?? listing.minPrice !== listing.maxPrice
+      minPrice: product.priceRange.minVariantPrice.amount,
+      maxPrice: product.priceRange.maxVariantPrice.amount,
+      minCompareAtPrice,
+      maxCompareAtPrice,
+      isPriceRange: product.priceRange.isPriceRange ?? product.priceRange.minVariantPrice.amount !== product.priceRange.maxVariantPrice.amount
     };
   }
   if (groups.length > 0) {
@@ -3526,26 +3495,13 @@ function buildProductListingGroupsByOption(args) {
     if (variants.length === 0) {
       return [];
     }
-    const listingBase = buildProductListingProjection(void 0, variants);
-    const orderedVariants = sortVariantsForMediaSelection(variants);
-    const productMediaPool = (args.product?.images ?? []).filter(
-      (image) => image != null && typeof image === "object"
-    );
-    const resolvedMedia = resolveProductSelectionMedia({
-      productMediaPool,
-      productPrimaryMediaItemId: extractEntityId(
-        args.product?.primaryMediaItemId ?? null
-      ),
-      selectedVariant: null,
-      matchingVariants: orderedVariants,
-      selectedOptionValues: [
-        {
-          id: value.id,
-          swatch: normalizeMatrixSwatch(value.swatch)
-        }
-      ]
-    });
-    const groupPrimaryImage = extractEntityId(resolvedMedia.primaryImage) ?? getFirstAvailableVariantPrimaryImage(variants) ?? extractEntityId(args.product?.thumbnail) ?? getFirstMediaId(args.product?.images);
+    const listingBase = buildProductListingGroupProjection(void 0, variants);
+    const normalizedSwatch = normalizeMatrixSwatch(value.swatch);
+    const swatchMediaId = normalizedSwatch?.mediaItemId == null ? null : String(normalizedSwatch.mediaItemId);
+    const groupPrimaryImage = inProductMediaPool(args.product, swatchMediaId) ?? inProductMediaPool(
+      args.product,
+      getFirstAvailableVariantPrimaryImage(variants)
+    ) ?? getFirstMediaId(args.product?.images);
     return [
       {
         optionId: primaryOption.id,
@@ -3618,15 +3574,19 @@ function buildProductListingPageWhere(params) {
   if (tagIds) clauses.push({ tags: { in: tagIds } });
   const minPrice = filters?.price?.min;
   if (minPrice != null) {
-    clauses.push({ "listing.maxPrice": { greater_than_equal: minPrice } });
+    clauses.push({
+      "priceRange.maxVariantPrice.amount": { greater_than_equal: minPrice }
+    });
   }
   const maxPrice = filters?.price?.max;
   if (maxPrice != null) {
-    clauses.push({ "listing.minPrice": { less_than_equal: maxPrice } });
+    clauses.push({
+      "priceRange.minVariantPrice.amount": { less_than_equal: maxPrice }
+    });
   }
   if (filters?.availableForSale != null) {
     clauses.push({
-      "listing.availableForSale": { equals: filters.availableForSale }
+      availableForSale: { equals: filters.availableForSale }
     });
   }
   if (clauses.length === 0) return void 0;
@@ -3851,6 +3811,12 @@ var OrderApi = class extends BaseApi {
       idempotencyRequestOptions(params.idempotencyKey)
     );
   }
+  /**
+   * Returns a `PublicOrder`-compatible shape even when the server backs the
+   * response with a Checkout (checkout/order separation, #1285). `orderNumber`
+   * stays the stable cross-window key. A breaking `PublicCheckout` split is a
+   * deferred follow-up (design D10 / Q3-b); do not change this return type here.
+   */
   checkout(params) {
     const { body, idempotencyKey } = splitIdempotencyKey(params);
     return this.request(
@@ -4228,17 +4194,19 @@ function mergeProductDetailWithStock(catalog, snapshot) {
     (sum, variant) => sum + Math.max(0, (variant.stock ?? 0) - (variant.reservedStock ?? 0)),
     0
   );
-  const { liveStockRequired: _liveStockRequired, ...listingBase } = catalog.listing;
   const availableForSale = snapshot.snapshots.some(
     (item) => item.status === "available" && item.availableForSale
   );
+  const selectedVariantId = typeof catalog.selectedOrFirstAvailableVariant === "object" && catalog.selectedOrFirstAvailableVariant !== null ? String(catalog.selectedOrFirstAvailableVariant.id) : catalog.selectedOrFirstAvailableVariant != null ? String(catalog.selectedOrFirstAvailableVariant) : null;
+  const selectedOrFirstAvailableVariant = selectedVariantId != null ? variants.find((variant) => String(variant.id) === selectedVariantId) ?? selectedVariantId : null;
   return {
     stockMergeStatus: missingSnapshotCount === 0 ? "complete" : "partial",
     product: {
       ...catalog,
       product: { ...catalog.product, totalInventory },
       variants,
-      listing: { ...listingBase, availableForSale }
+      availableForSale,
+      selectedOrFirstAvailableVariant
     }
   };
 }
@@ -4518,6 +4486,7 @@ var INTERNAL_COLLECTIONS = [
   "commerce-notification-intents",
   "product-collection-items",
   "order-status-logs",
+  "tenant-commerce-config",
   "api-keys",
   "personal-access-tokens",
   "tenant-entitlements",
@@ -4542,6 +4511,7 @@ var COLLECTIONS = [
   "product-collections",
   "brands",
   "customer-profiles",
+  "customer-profile-stats",
   "discounts",
   "shipping-policies",
   "shipping-zones",
@@ -4570,8 +4540,6 @@ var COLLECTIONS = [
   "canvas-edge-types",
   "canvas-categories",
   "canvas-tags",
-  "canvas-nodes",
-  "canvas-edges",
   "video-categories",
   "video-tags",
   "forms",
@@ -4606,11 +4574,15 @@ var SERVER_ONLY_COLLECTIONS = [
   "form-submissions",
   "carts",
   "cart-items",
+  "checkouts",
+  "checkout-items",
   "posts",
   "comments",
   "reactions",
   "bookmarks",
   "live-streams",
+  "canvas-nodes",
+  "canvas-edges",
   "customer-groups",
   "reports",
   "community-bans",
@@ -4788,8 +4760,7 @@ function resolveProductMedia(input) {
     };
   }
   const display = resolveProductDisplayMedia({
-    productMediaPool: input.productMediaPool,
-    productPrimaryMediaItemId: input.productPrimaryMediaItemId
+    productMediaPool: input.productMediaPool
   });
   return {
     primaryImage: display.primaryImage,
@@ -4917,8 +4888,7 @@ function resolveProductGallery(input) {
   if (legacyResolved && legacyResolved.source !== "none") return legacyResolved;
   return resolveProductDisplayMedia({
     productMediaPool: input.productMediaPool ?? input.pool ?? null,
-    productPrimaryMediaItemId: input.productPrimaryMediaItemId,
-    listingPrimaryImage: input.listingPrimaryImage
+    featuredImage: input.featuredImage
   });
 }