Woo Inventory

1'use strict';
2
3// Source policy only. The target adapter owns how these canonical values are written.
4function mapWooInventory(source = {}, { parent } = {}) {
5  const gap = (reason) => ({ status: 'decision-needed', fields: {}, reason });
6  if (source.backorders_allowed === true || source.backordered === true ||
7      (source.backorders != null && source.backorders !== 'no') || source.stock_status === 'onbackorder') {
8    return gap('backorder-policy');
9  }
10  if (source.manage_stock === 'parent' ||
11      (parent && parent.manage_stock === true && source.manage_stock !== true)) {
12    return gap('shared-parent-stock');
13  }
14  if (!['instock', 'outofstock'].includes(source.stock_status)) return gap('missing-or-unknown-stock-status');
15  if (source.manage_stock === false) {
16    return { status: 'mapped', fields: { inventoryTracked: false, inStock: source.stock_status === 'instock' } };
17  }
18  if (source.manage_stock !== true) return gap('missing-or-unknown-tracking-method');
19  const quantity = source.stock_quantity;
20  // LIVE-FOUND: a tracked product marked out of stock with no quantity (null) or an oversold
21  // negative one. stock_status already says it cannot be bought, so it is tracked at 0 -- the same
22  // storefront state -- instead of holding the product. In stock with no usable quantity stays a gap.
23  if (source.stock_status === 'outofstock' && (quantity === null || quantity === undefined || (Number.isInteger(quantity) && quantity < 0))) {
24    return { status: 'mapped', fields: { inventoryTracked: true, inventoryQuantity: 0 }, note: quantity == null ? 'out-of-stock-quantity-missing' : 'out-of-stock-quantity-negative' };
25  }
26  if (!Number.isInteger(quantity) || quantity < 0 || quantity > 99999) return gap('invalid-stock-quantity');
27  if ((quantity > 0) !== (source.stock_status === 'instock')) return gap('stock-status-quantity-conflict');
28  return { status: 'mapped', fields: { inventoryTracked: true, inventoryQuantity: quantity } };
29}
30
31module.exports = { mapWooInventory };