Shopify Bundles

1'use strict';
2
3// Shopify bundles -> the canonical product.bundle (rp-target-wix/lib/wix-target-spec.js
4// validateCanonicalBundle). This file only reads how Shopify stores a bundle; what Wix does with it
5// is decided on the target side (stores/product-bundle, lib/stores-bundle-cutover.js).
6//
7// A Shopify bundle is a variant with `requiresComponents: true` whose `productVariantComponents`
8// (read per bundle variant by lib/shopify-nested-reads.js) list the component variants and their
9// quantities (Admin GraphQL ProductVariant / ProductVariantComponent, schema 2026-10). The bundle's
10// price is the variant's own price and Shopify derives its availability from the components.
11//
12// Input: one folded products row. Output: { hasBundleFields, bundle, unreadableReason }.
13
14function canonicalBundleFromShopifyProduct(product) {
15  const variants = Array.isArray(product?.variants) ? product.variants : [];
16  const bundles = variants.filter((variant) => variant && variant.requiresComponents === true);
17  if (!bundles.length) return { hasBundleFields: false, bundle: null, unreadableReason: null };
18  // One canonical bundle is one product. Several bundle variants can hold different parts each;
19  // the operator takes those from the source rather than from a merged guess.
20  if (bundles.length > 1) {
21    return { hasBundleFields: true, bundle: null, unreadableReason: `${bundles.length} variants are bundles with their own parts` };
22  }
23  const components = bundles[0].productVariantComponents;
24  if (!Array.isArray(components) || !components.length) {
25    return { hasBundleFields: true, bundle: null, unreadableReason: 'the bundle variant\'s components were not read' };
26  }
27  const parts = [];
28  for (const component of components) {
29    const variantId = component?.productVariant?.id;
30    const productId = component?.productVariant?.product?.id;
31    if (typeof variantId !== 'string' || typeof productId !== 'string' || !Number.isInteger(component.quantity) || component.quantity < 1) {
32      return { hasBundleFields: true, bundle: null, unreadableReason: 'a component has no variant, product or quantity' };
33    }
34    parts.push({ sourceProductId: productId, sourceVariantId: variantId, quantity: component.quantity, optional: false });
35  }
36  return {
37    hasBundleFields: true,
38    unreadableReason: null,
39    bundle: { kind: 'fixed', components: parts, groups: [], priceRule: 'fixed', stockRule: 'from-components', detectedBy: 'shopify:bundle-variant' },
40  };
41}
42
43module.exports = { canonicalBundleFromShopifyProduct };