@open-mercato/core 0.8.1-develop.7296.1.2111d779db → 0.8.1-develop.7441.1.b42958b98c

package/dist/modules/wms/di.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/modules/wms/di.ts"],
-  "sourcesContent": ["import { asValue } from 'awilix'\nimport type { AppContainer } from '@open-mercato/shared/lib/di/container'\nimport {\n  InventoryBalance,\n  InventoryLot,\n  InventoryMovement,\n  InventoryReservation,\n  ProductInventoryProfile,\n  Warehouse,\n  WarehouseLocation,\n  WarehouseZone,\n} from './data/entities'\n\nexport function register(container: AppContainer) {\n  container.register({\n    Warehouse: asValue(Warehouse),\n    WarehouseZone: asValue(WarehouseZone),\n    WarehouseLocation: asValue(WarehouseLocation),\n    ProductInventoryProfile: asValue(ProductInventoryProfile),\n    InventoryLot: asValue(InventoryLot),\n    InventoryBalance: asValue(InventoryBalance),\n    InventoryReservation: asValue(InventoryReservation),\n    InventoryMovement: asValue(InventoryMovement),\n  })\n}\n"],
-  "mappings": "AAAA,SAAS,eAAe;AAExB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,SAAS,SAAS,WAAyB;AAChD,YAAU,SAAS;AAAA,IACjB,WAAW,QAAQ,SAAS;AAAA,IAC5B,eAAe,QAAQ,aAAa;AAAA,IACpC,mBAAmB,QAAQ,iBAAiB;AAAA,IAC5C,yBAAyB,QAAQ,uBAAuB;AAAA,IACxD,cAAc,QAAQ,YAAY;AAAA,IAClC,kBAAkB,QAAQ,gBAAgB;AAAA,IAC1C,sBAAsB,QAAQ,oBAAoB;AAAA,IAClD,mBAAmB,QAAQ,iBAAiB;AAAA,EAC9C,CAAC;AACH;",
+  "sourcesContent": ["import { asValue } from 'awilix'\nimport type { AppContainer } from '@open-mercato/shared/lib/di/container'\nimport { availabilityProviderRegistry } from '@open-mercato/shared/lib/availability'\nimport {\n  InventoryBalance,\n  InventoryLot,\n  InventoryMovement,\n  InventoryReservation,\n  ProductInventoryProfile,\n  Warehouse,\n  WarehouseLocation,\n  WarehouseZone,\n} from './data/entities'\nimport { WMS_AVAILABILITY_PROVIDER_ID, wmsAvailabilityProvider } from './lib/availabilityProvider'\n\nexport function register(container: AppContainer) {\n  container.register({\n    Warehouse: asValue(Warehouse),\n    WarehouseZone: asValue(WarehouseZone),\n    WarehouseLocation: asValue(WarehouseLocation),\n    ProductInventoryProfile: asValue(ProductInventoryProfile),\n    InventoryLot: asValue(InventoryLot),\n    InventoryBalance: asValue(InventoryBalance),\n    InventoryReservation: asValue(InventoryReservation),\n    InventoryMovement: asValue(InventoryMovement),\n  })\n\n  if (availabilityProviderRegistry.get(WMS_AVAILABILITY_PROVIDER_ID) !== wmsAvailabilityProvider) {\n    availabilityProviderRegistry.register(wmsAvailabilityProvider)\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,eAAe;AAExB,SAAS,oCAAoC;AAC7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,8BAA8B,+BAA+B;AAE/D,SAAS,SAAS,WAAyB;AAChD,YAAU,SAAS;AAAA,IACjB,WAAW,QAAQ,SAAS;AAAA,IAC5B,eAAe,QAAQ,aAAa;AAAA,IACpC,mBAAmB,QAAQ,iBAAiB;AAAA,IAC5C,yBAAyB,QAAQ,uBAAuB;AAAA,IACxD,cAAc,QAAQ,YAAY;AAAA,IAClC,kBAAkB,QAAQ,gBAAgB;AAAA,IAC1C,sBAAsB,QAAQ,oBAAoB;AAAA,IAClD,mBAAmB,QAAQ,iBAAiB;AAAA,EAC9C,CAAC;AAED,MAAI,6BAA6B,IAAI,4BAA4B,MAAM,yBAAyB;AAC9F,iCAA6B,SAAS,uBAAuB;AAAA,EAC/D;AACF;",
   "names": []
 }

package/dist/modules/wms/lib/availabilityCache.js

@@ -0,0 +1,86 @@
+import { runWithCacheTenant } from "@open-mercato/cache";
+import { createLogger } from "@open-mercato/shared/lib/logger";
+import { availabilityItemKey } from "@open-mercato/shared/lib/availability";
+import { computeAvailability } from "./availabilityCalculation.js";
+const WMS_AVAILABILITY_CACHE_TAG = "wms:availability";
+const WMS_AVAILABILITY_CACHE_TTL_MS = 6e4;
+const logger = createLogger("wms").child({ component: "availability-cache" });
+function resolveCache(container) {
+  if (!container?.resolve) return null;
+  for (const name of ["cache", "cacheService"]) {
+    try {
+      const candidate = container.resolve(name);
+      if (candidate && typeof candidate.deleteByTags === "function") return candidate;
+    } catch {
+    }
+  }
+  return null;
+}
+function cacheKeyForItem(query, item) {
+  return [
+    "wms:availability",
+    query.organizationId,
+    query.storeId ?? "",
+    query.locationIds && query.locationIds.length > 0 ? [...query.locationIds].sort((left, right) => left.localeCompare(right)).join(",") : "*",
+    item.catalogProductId,
+    item.catalogVariantId ?? "",
+    item.quantity
+  ].join(":");
+}
+async function computeAvailabilityCached(em, container, query) {
+  const cache = resolveCache(container);
+  if (!cache || query.bypassCache) {
+    return computeAvailability(em, container, query);
+  }
+  return runWithCacheTenant(query.tenantId, async () => {
+    const byItem = {};
+    const missed = [];
+    for (const item of query.items) {
+      const key = availabilityItemKey(item);
+      try {
+        const cached = await cache.get(cacheKeyForItem(query, item));
+        if (cached) {
+          byItem[key] = { ...cached, isAuthoritative: false };
+          continue;
+        }
+      } catch (err) {
+        logger.warn("Availability cache read failed; computing live", { key, err });
+      }
+      missed.push(item);
+    }
+    if (missed.length > 0) {
+      const live = await computeAvailability(em, container, { ...query, items: missed });
+      for (const item of missed) {
+        const key = availabilityItemKey(item);
+        const result = live.byItem[key];
+        byItem[key] = result;
+        try {
+          await cache.set(cacheKeyForItem(query, item), result, {
+            ttl: WMS_AVAILABILITY_CACHE_TTL_MS,
+            tags: [WMS_AVAILABILITY_CACHE_TAG]
+          });
+        } catch (err) {
+          logger.warn("Availability cache write failed", { key, err });
+        }
+      }
+    }
+    return { byItem };
+  });
+}
+async function invalidateWmsAvailabilityCache(container, tenantId) {
+  if (!tenantId) return;
+  const cache = resolveCache(container);
+  if (!cache) return;
+  try {
+    await runWithCacheTenant(tenantId, () => cache.deleteByTags([WMS_AVAILABILITY_CACHE_TAG]));
+  } catch (err) {
+    logger.warn("Failed to invalidate wms availability cache", { tenantId, err });
+  }
+}
+export {
+  WMS_AVAILABILITY_CACHE_TAG,
+  WMS_AVAILABILITY_CACHE_TTL_MS,
+  computeAvailabilityCached,
+  invalidateWmsAvailabilityCache
+};
+//# sourceMappingURL=availabilityCache.js.map

package/dist/modules/wms/lib/availabilityCache.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/availabilityCache.ts"],
+  "sourcesContent": ["/**\n * Read-through cache for `wms`'s `AvailabilityProvider` \u2014 \u00A76 staleness\n * budget (60s TTL for a browse-time `check`, never cached for\n * `query.bypassCache`), tag-based invalidation on `wms` balance changes.\n *\n * Tag granularity is a deliberate deviation from \u00A76's literal\n * `availability:{tenantId}:{variantId}` naming: this module already has a\n * coarse, tenant-scoped tag for the same purpose\n * (`enricherCacheTags.ts`'s `WMS_INVENTORY_CACHE_TAG`), justified there as\n * \"collection tags over-invalidate slightly; a per-warehouse scheme the\n * write side could miss would under-invalidate, which is the failure that\n * actually shows wrong stock to a user.\" The same reasoning applies here, so\n * `WMS_AVAILABILITY_CACHE_TAG` follows that established precedent rather\n * than a literal per-variant tag. `runWithCacheTenant` already scopes both\n * keys and tags to the current tenant (`packages/cache/src/service.ts`), so\n * neither needs `tenantId` embedded manually.\n */\n\nimport { runWithCacheTenant } from '@open-mercato/cache'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { availabilityItemKey } from '@open-mercato/shared/lib/availability'\nimport type { AvailabilityItemResult, AvailabilityQuery, AvailabilityResult } from '@open-mercato/shared/lib/availability'\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { computeAvailability } from './availabilityCalculation'\n\nexport const WMS_AVAILABILITY_CACHE_TAG = 'wms:availability'\n/** \u00A76 staleness budget: a browse-time `check` may be up to 60s stale. */\nexport const WMS_AVAILABILITY_CACHE_TTL_MS = 60_000\n\nconst logger = createLogger('wms').child({ component: 'availability-cache' })\n\ntype CacheService = {\n  get(key: string, options?: { returnExpired?: boolean }): Promise<unknown>\n  set(key: string, value: unknown, options?: { ttl?: number; tags?: string[] }): Promise<void>\n  deleteByTags(tags: string[]): Promise<number>\n}\n\ntype Resolver = { resolve: <T = unknown>(name: string) => T }\n\nfunction resolveCache(container: Resolver | null | undefined): CacheService | null {\n  if (!container?.resolve) return null\n  for (const name of ['cache', 'cacheService']) {\n    try {\n      const candidate = container.resolve<CacheService>(name)\n      if (candidate && typeof candidate.deleteByTags === 'function') return candidate\n    } catch {\n      // try the next registration name\n    }\n  }\n  return null\n}\n\nfunction cacheKeyForItem(query: AvailabilityQuery, item: AvailabilityQuery['items'][number]): string {\n  return [\n    'wms:availability',\n    query.organizationId,\n    query.storeId ?? '',\n    query.locationIds && query.locationIds.length > 0 ? [...query.locationIds].sort((left, right) => left.localeCompare(right)).join(',') : '*',\n    item.catalogProductId,\n    item.catalogVariantId ?? '',\n    item.quantity,\n  ].join(':')\n}\n\n/**\n * Wraps `computeAvailability` with the read-through cache. Falls back to a\n * live computation when no cache service is registered or `bypassCache` is\n * set \u2014 the same code path either way, just without the read/write.\n */\nexport async function computeAvailabilityCached(\n  em: EntityManager,\n  container: Resolver,\n  query: AvailabilityQuery,\n): Promise<AvailabilityResult> {\n  const cache = resolveCache(container)\n  if (!cache || query.bypassCache) {\n    return computeAvailability(em, container, query)\n  }\n\n  return runWithCacheTenant(query.tenantId, async () => {\n    const byItem: AvailabilityResult['byItem'] = {}\n    const missed: AvailabilityQuery['items'] = []\n\n    for (const item of query.items) {\n      const key = availabilityItemKey(item)\n      try {\n        const cached = await cache.get(cacheKeyForItem(query, item))\n        if (cached) {\n          byItem[key] = { ...(cached as AvailabilityItemResult), isAuthoritative: false }\n          continue\n        }\n      } catch (err) {\n        logger.warn('Availability cache read failed; computing live', { key, err })\n      }\n      missed.push(item)\n    }\n\n    if (missed.length > 0) {\n      const live = await computeAvailability(em, container, { ...query, items: missed })\n      for (const item of missed) {\n        const key = availabilityItemKey(item)\n        const result = live.byItem[key]\n        byItem[key] = result\n        try {\n          await cache.set(cacheKeyForItem(query, item), result, {\n            ttl: WMS_AVAILABILITY_CACHE_TTL_MS,\n            tags: [WMS_AVAILABILITY_CACHE_TAG],\n          })\n        } catch (err) {\n          logger.warn('Availability cache write failed', { key, err })\n        }\n      }\n    }\n\n    return { byItem }\n  })\n}\n\n/**\n * Best-effort tag invalidation \u2014 mirrors\n * `invalidateInventoryEnricherCache.ts`. A failure is logged and swallowed:\n * invalidation must never fail the write that triggered it, and the TTL\n * bounds how long a missed drop can serve stale data.\n */\nexport async function invalidateWmsAvailabilityCache(\n  container: Resolver | null | undefined,\n  tenantId: string | null | undefined,\n): Promise<void> {\n  if (!tenantId) return\n  const cache = resolveCache(container)\n  if (!cache) return\n  try {\n    await runWithCacheTenant(tenantId, () => cache.deleteByTags([WMS_AVAILABILITY_CACHE_TAG]))\n  } catch (err) {\n    logger.warn('Failed to invalidate wms availability cache', { tenantId, err })\n  }\n}\n"],
+  "mappings": "AAkBA,SAAS,0BAA0B;AACnC,SAAS,oBAAoB;AAC7B,SAAS,2BAA2B;AAGpC,SAAS,2BAA2B;AAE7B,MAAM,6BAA6B;AAEnC,MAAM,gCAAgC;AAE7C,MAAM,SAAS,aAAa,KAAK,EAAE,MAAM,EAAE,WAAW,qBAAqB,CAAC;AAU5E,SAAS,aAAa,WAA6D;AACjF,MAAI,CAAC,WAAW,QAAS,QAAO;AAChC,aAAW,QAAQ,CAAC,SAAS,cAAc,GAAG;AAC5C,QAAI;AACF,YAAM,YAAY,UAAU,QAAsB,IAAI;AACtD,UAAI,aAAa,OAAO,UAAU,iBAAiB,WAAY,QAAO;AAAA,IACxE,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,gBAAgB,OAA0B,MAAkD;AACnG,SAAO;AAAA,IACL;AAAA,IACA,MAAM;AAAA,IACN,MAAM,WAAW;AAAA,IACjB,MAAM,eAAe,MAAM,YAAY,SAAS,IAAI,CAAC,GAAG,MAAM,WAAW,EAAE,KAAK,CAAC,MAAM,UAAU,KAAK,cAAc,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;AAAA,IACxI,KAAK;AAAA,IACL,KAAK,oBAAoB;AAAA,IACzB,KAAK;AAAA,EACP,EAAE,KAAK,GAAG;AACZ;AAOA,eAAsB,0BACpB,IACA,WACA,OAC6B;AAC7B,QAAM,QAAQ,aAAa,SAAS;AACpC,MAAI,CAAC,SAAS,MAAM,aAAa;AAC/B,WAAO,oBAAoB,IAAI,WAAW,KAAK;AAAA,EACjD;AAEA,SAAO,mBAAmB,MAAM,UAAU,YAAY;AACpD,UAAM,SAAuC,CAAC;AAC9C,UAAM,SAAqC,CAAC;AAE5C,eAAW,QAAQ,MAAM,OAAO;AAC9B,YAAM,MAAM,oBAAoB,IAAI;AACpC,UAAI;AACF,cAAM,SAAS,MAAM,MAAM,IAAI,gBAAgB,OAAO,IAAI,CAAC;AAC3D,YAAI,QAAQ;AACV,iBAAO,GAAG,IAAI,EAAE,GAAI,QAAmC,iBAAiB,MAAM;AAC9E;AAAA,QACF;AAAA,MACF,SAAS,KAAK;AACZ,eAAO,KAAK,kDAAkD,EAAE,KAAK,IAAI,CAAC;AAAA,MAC5E;AACA,aAAO,KAAK,IAAI;AAAA,IAClB;AAEA,QAAI,OAAO,SAAS,GAAG;AACrB,YAAM,OAAO,MAAM,oBAAoB,IAAI,WAAW,EAAE,GAAG,OAAO,OAAO,OAAO,CAAC;AACjF,iBAAW,QAAQ,QAAQ;AACzB,cAAM,MAAM,oBAAoB,IAAI;AACpC,cAAM,SAAS,KAAK,OAAO,GAAG;AAC9B,eAAO,GAAG,IAAI;AACd,YAAI;AACF,gBAAM,MAAM,IAAI,gBAAgB,OAAO,IAAI,GAAG,QAAQ;AAAA,YACpD,KAAK;AAAA,YACL,MAAM,CAAC,0BAA0B;AAAA,UACnC,CAAC;AAAA,QACH,SAAS,KAAK;AACZ,iBAAO,KAAK,mCAAmC,EAAE,KAAK,IAAI,CAAC;AAAA,QAC7D;AAAA,MACF;AAAA,IACF;AAEA,WAAO,EAAE,OAAO;AAAA,EAClB,CAAC;AACH;AAQA,eAAsB,+BACpB,WACA,UACe;AACf,MAAI,CAAC,SAAU;AACf,QAAM,QAAQ,aAAa,SAAS;AACpC,MAAI,CAAC,MAAO;AACZ,MAAI;AACF,UAAM,mBAAmB,UAAU,MAAM,MAAM,aAAa,CAAC,0BAA0B,CAAC,CAAC;AAAA,EAC3F,SAAS,KAAK;AACZ,WAAO,KAAK,+CAA+C,EAAE,UAAU,IAAI,CAAC;AAAA,EAC9E;AACF;",
+  "names": []
+}

package/dist/modules/wms/lib/availabilityCalculation.js

@@ -0,0 +1,212 @@
+import { availabilityItemKey } from "@open-mercato/shared/lib/availability";
+import { tryResolve } from "./tryResolve.js";
+import { buildSqlInClause } from "./sqlInClause.js";
+const OPEN_POLICY_DEFAULT = {
+  isStockManaged: { value: true, policySourceId: null },
+  allowBackorder: { value: false, policySourceId: null },
+  backorderLeadTimeDays: { value: null, policySourceId: null },
+  preorderReleaseAt: { value: null, policySourceId: null },
+  lowStockThreshold: { value: null, policySourceId: null },
+  minOrderQuantity: { value: null, policySourceId: null },
+  maxOrderQuantity: { value: null, policySourceId: null },
+  quantityIncrement: { value: null, policySourceId: null },
+  isActive: { value: true, policySourceId: null }
+};
+async function loadBalanceAggregates(em, tenantId, organizationId, variantIds, locationIds) {
+  const result = /* @__PURE__ */ new Map();
+  if (variantIds.length === 0) return result;
+  const variantClause = buildSqlInClause("b.catalog_variant_id", variantIds);
+  const params = [organizationId, tenantId, ...variantClause.params];
+  let locationClause = "";
+  if (locationIds && locationIds.length > 0) {
+    const locationIn = buildSqlInClause("b.location_id", locationIds);
+    locationClause = ` and ${locationIn.sql}`;
+    params.push(...locationIn.params);
+  }
+  const sql = `
+    select b.catalog_variant_id,
+           sum(coalesce(b.quantity_on_hand, 0) - coalesce(b.quantity_reserved, 0) - coalesce(b.quantity_allocated, 0)) as aggregate_available
+    from wms_inventory_balances b
+    where b.organization_id = ? and b.tenant_id = ? and ${variantClause.sql} and b.deleted_at is null
+      ${locationClause}
+    group by b.catalog_variant_id
+  `;
+  const rows = await em.getConnection().execute(sql, params);
+  for (const row of rows) {
+    result.set(row.catalog_variant_id, Number(row.aggregate_available ?? 0));
+  }
+  return result;
+}
+async function loadProfiles(em, tenantId, organizationId, variantIds, productIds) {
+  if (variantIds.length === 0 && productIds.length === 0) return [];
+  const variantClause = buildSqlInClause("catalog_variant_id", variantIds);
+  const productClause = buildSqlInClause("catalog_product_id", productIds);
+  const sql = `
+    select catalog_product_id, catalog_variant_id, safety_stock, reorder_point
+    from wms_product_inventory_profiles
+    where organization_id = ? and tenant_id = ? and deleted_at is null
+      and (${variantClause.sql} or (${productClause.sql} and catalog_variant_id is null))
+  `;
+  return em.getConnection().execute(sql, [
+    organizationId,
+    tenantId,
+    ...variantClause.params,
+    ...productClause.params
+  ]);
+}
+async function loadActiveVariantsForProducts(em, tenantId, organizationId, productIds) {
+  if (productIds.length === 0) return [];
+  const productClause = buildSqlInClause("product_id", productIds);
+  const sql = `
+    select id, product_id
+    from catalog_product_variants
+    where organization_id = ? and tenant_id = ? and ${productClause.sql} and is_active = true and deleted_at is null
+  `;
+  return em.getConnection().execute(sql, [organizationId, tenantId, ...productClause.params]);
+}
+function findProfile(profiles, productId, variantId) {
+  if (variantId) {
+    const variantRow = profiles.find((p) => p.catalog_variant_id === variantId);
+    if (variantRow) return variantRow;
+  }
+  return profiles.find((p) => p.catalog_product_id === productId && !p.catalog_variant_id) ?? null;
+}
+function openPolicyDefaultFor(profiles, productId, variantId) {
+  const hasProfile = findProfile(profiles, productId, variantId) !== null;
+  return { ...OPEN_POLICY_DEFAULT, isStockManaged: { value: hasProfile, policySourceId: null } };
+}
+function computeState(params) {
+  if (!params.isActive) {
+    return { state: "out_of_stock", canFulfil: false, leadTimeDays: null, releaseAt: null };
+  }
+  if (params.preorderReleaseAt && params.preorderReleaseAt.getTime() > Date.now()) {
+    return { state: "preorder", canFulfil: true, leadTimeDays: null, releaseAt: params.preorderReleaseAt.toISOString() };
+  }
+  if (params.sellable >= params.requested) {
+    const state = params.lowStockThreshold != null && params.sellable <= params.lowStockThreshold ? "low_stock" : "in_stock";
+    return { state, canFulfil: true, leadTimeDays: null, releaseAt: null };
+  }
+  if (params.allowBackorder) {
+    return { state: "backorder", canFulfil: true, leadTimeDays: params.backorderLeadTimeDays, releaseAt: null };
+  }
+  return { state: "out_of_stock", canFulfil: false, leadTimeDays: null, releaseAt: null };
+}
+function isWithinOrderQuantityRules(requested, policy) {
+  const min = policy.minOrderQuantity.value;
+  const max = policy.maxOrderQuantity.value;
+  const increment = policy.quantityIncrement.value;
+  if (min != null && requested < min) return false;
+  if (max != null && requested > max) return false;
+  if (increment != null && increment > 0 && requested % increment !== 0) return false;
+  return true;
+}
+function computeUntrackedItem(policy) {
+  const base = {
+    state: "not_tracked",
+    availableQuantity: null,
+    canFulfil: true,
+    leadTimeDays: null,
+    releaseAt: null,
+    isAuthoritative: true,
+    policySourceId: policy.isStockManaged.policySourceId
+  };
+  if (!policy.isActive.value) {
+    return { ...base, state: "out_of_stock", canFulfil: false, policySourceId: policy.isActive.policySourceId };
+  }
+  const preorderReleaseAt = policy.preorderReleaseAt.value;
+  if (preorderReleaseAt && preorderReleaseAt.getTime() > Date.now()) {
+    return {
+      ...base,
+      state: "preorder",
+      releaseAt: preorderReleaseAt.toISOString(),
+      policySourceId: policy.preorderReleaseAt.policySourceId
+    };
+  }
+  return base;
+}
+async function computeAvailability(em, container, query) {
+  const byItem = {};
+  if (query.items.length === 0) return { byItem };
+  const variantItems = query.items.filter((item) => !!item.catalogVariantId);
+  const productItems = query.items.filter((item) => !item.catalogVariantId);
+  const productItemIds = Array.from(new Set(productItems.map((item) => item.catalogProductId)));
+  const rollupVariantRows = await loadActiveVariantsForProducts(em, query.tenantId, query.organizationId, productItemIds);
+  const variantsByProduct = /* @__PURE__ */ new Map();
+  for (const row of rollupVariantRows) {
+    const list = variantsByProduct.get(row.product_id) ?? [];
+    list.push(row.id);
+    variantsByProduct.set(row.product_id, list);
+  }
+  const allVariantIds = Array.from(
+    /* @__PURE__ */ new Set([
+      ...variantItems.map((item) => item.catalogVariantId),
+      ...rollupVariantRows.map((row) => row.id)
+    ])
+  );
+  const allProductIds = Array.from(new Set(query.items.map((item) => item.catalogProductId)));
+  const [balances, profiles] = await Promise.all([
+    loadBalanceAggregates(em, query.tenantId, query.organizationId, allVariantIds, query.locationIds),
+    loadProfiles(em, query.tenantId, query.organizationId, allVariantIds, allProductIds)
+  ]);
+  const policyService = tryResolve(container, "policyResolutionService");
+  const policyScopes = query.items.map((item) => ({
+    tenantId: query.tenantId,
+    organizationId: query.organizationId,
+    storeId: query.storeId ?? null,
+    productId: item.catalogProductId,
+    variantId: item.catalogVariantId ?? null
+  }));
+  const resolvedPolicies = policyService ? await policyService.resolveMany(em, policyScopes) : query.items.map((item) => openPolicyDefaultFor(profiles, item.catalogProductId, item.catalogVariantId ?? null));
+  function sellableFor(variantId, productId) {
+    const aggregate = balances.get(variantId) ?? 0;
+    const profile = findProfile(profiles, productId, variantId);
+    const safetyStock = profile ? Number(profile.safety_stock ?? 0) : 0;
+    return Math.max(0, aggregate - safetyStock);
+  }
+  query.items.forEach((item, index) => {
+    const policy = resolvedPolicies[index] ?? openPolicyDefaultFor(profiles, item.catalogProductId, item.catalogVariantId ?? null);
+    const key = availabilityItemKey(item);
+    const withinOrderQuantityRules = isWithinOrderQuantityRules(item.quantity, policy);
+    if (!policy.isStockManaged.value) {
+      const untracked = computeUntrackedItem(policy);
+      byItem[key] = { ...untracked, canFulfil: untracked.canFulfil && withinOrderQuantityRules };
+      return;
+    }
+    let sellable;
+    let reorderPoint = null;
+    if (item.catalogVariantId) {
+      sellable = sellableFor(item.catalogVariantId, item.catalogProductId);
+      const profile = findProfile(profiles, item.catalogProductId, item.catalogVariantId);
+      reorderPoint = profile && profile.reorder_point != null ? Number(profile.reorder_point) : null;
+    } else {
+      const variantIds = variantsByProduct.get(item.catalogProductId) ?? [];
+      sellable = variantIds.reduce((sum, variantId) => sum + sellableFor(variantId, item.catalogProductId), 0);
+      const profile = findProfile(profiles, item.catalogProductId, null);
+      reorderPoint = profile && profile.reorder_point != null ? Number(profile.reorder_point) : null;
+    }
+    const effectiveLowStockThreshold = policy.lowStockThreshold.value ?? reorderPoint;
+    const computed = computeState({
+      sellable,
+      requested: item.quantity,
+      lowStockThreshold: effectiveLowStockThreshold,
+      allowBackorder: policy.allowBackorder.value,
+      backorderLeadTimeDays: policy.backorderLeadTimeDays.value,
+      preorderReleaseAt: policy.preorderReleaseAt.value,
+      isActive: policy.isActive.value
+    });
+    byItem[key] = {
+      state: computed.state,
+      availableQuantity: sellable,
+      canFulfil: computed.canFulfil && withinOrderQuantityRules,
+      leadTimeDays: computed.leadTimeDays,
+      releaseAt: computed.releaseAt,
+      isAuthoritative: true,
+      policySourceId: policy.isStockManaged.policySourceId
+    };
+  });
+  return { byItem };
+}
+export {
+  computeAvailability
+};
+//# sourceMappingURL=availabilityCalculation.js.map

package/dist/modules/wms/lib/availabilityCalculation.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/availabilityCalculation.ts"],
+  "sourcesContent": ["/**\n * `wms`'s `AvailabilityProvider` computation \u2014 batched sellable-quantity\n * aggregation, safety-stock handling, low-stock thresholds, and product\n * rollup.\n *\n * @see .ai/specs/2026-08-14-availability-contract.md \u00A74.2\n *\n * Batching contract (R4): exactly one balance aggregation, one profile\n * lookup, one policy lookup, and (only when the batch has product-level\n * items) one variant-rollup lookup \u2014 never per item.\n *\n * Safety-stock contract (R1): `sellable = max(0, aggregate_available -\n * safety_stock)`, with `safety_stock` subtracted ONCE per variant, after\n * aggregating every in-scope location \u2014 never once per balance row.\n */\n\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport { availabilityItemKey } from '@open-mercato/shared/lib/availability'\nimport type { AvailabilityItemResult, AvailabilityQuery, AvailabilityResult, AvailabilityState } from '@open-mercato/shared/lib/availability'\nimport { tryResolve } from './tryResolve'\nimport { buildSqlInClause } from './sqlInClause'\n\ntype Resolver = { resolve: <T = unknown>(name: string) => T }\n\n/**\n * Narrow, locally-declared duck type for `availability`'s `PolicyResolutionService`\n * (soft-resolved, never statically imported \u2014 `wms` never hard-requires `availability`,\n * \u00A73.1). Structurally identical to the real service's relevant surface.\n */\ntype PolicyField<T> = { value: T; policySourceId: string | null }\ntype ResolvedPolicyOverlay = {\n  isStockManaged: PolicyField<boolean>\n  allowBackorder: PolicyField<boolean>\n  backorderLeadTimeDays: PolicyField<number | null>\n  preorderReleaseAt: PolicyField<Date | null>\n  lowStockThreshold: PolicyField<number | null>\n  minOrderQuantity: PolicyField<number | null>\n  maxOrderQuantity: PolicyField<number | null>\n  quantityIncrement: PolicyField<number | null>\n  isActive: PolicyField<boolean>\n}\ntype PolicyResolutionScopeLike = {\n  tenantId: string\n  organizationId: string\n  storeId?: string | null\n  productId: string\n  variantId?: string | null\n}\ntype PolicyResolutionServiceLike = {\n  resolveMany(em: EntityManager, scopes: PolicyResolutionScopeLike[]): Promise<ResolvedPolicyOverlay[]>\n}\n\nconst OPEN_POLICY_DEFAULT: ResolvedPolicyOverlay = {\n  isStockManaged: { value: true, policySourceId: null },\n  allowBackorder: { value: false, policySourceId: null },\n  backorderLeadTimeDays: { value: null, policySourceId: null },\n  preorderReleaseAt: { value: null, policySourceId: null },\n  lowStockThreshold: { value: null, policySourceId: null },\n  minOrderQuantity: { value: null, policySourceId: null },\n  maxOrderQuantity: { value: null, policySourceId: null },\n  quantityIncrement: { value: null, policySourceId: null },\n  isActive: { value: true, policySourceId: null },\n}\n\ntype BalanceAggregateRow = { catalog_variant_id: string; aggregate_available: string | number | null }\ntype ProfileRow = {\n  catalog_product_id: string\n  catalog_variant_id: string | null\n  safety_stock: string | number | null\n  reorder_point: string | number | null\n}\ntype VariantRow = { id: string; product_id: string }\n\nasync function loadBalanceAggregates(\n  em: EntityManager,\n  tenantId: string,\n  organizationId: string,\n  variantIds: string[],\n  locationIds?: string[] | null,\n): Promise<Map<string, number>> {\n  const result = new Map<string, number>()\n  if (variantIds.length === 0) return result\n\n  const variantClause = buildSqlInClause('b.catalog_variant_id', variantIds)\n  const params: unknown[] = [organizationId, tenantId, ...variantClause.params]\n  let locationClause = ''\n  if (locationIds && locationIds.length > 0) {\n    const locationIn = buildSqlInClause('b.location_id', locationIds)\n    locationClause = ` and ${locationIn.sql}`\n    params.push(...locationIn.params)\n  }\n\n  const sql = `\n    select b.catalog_variant_id,\n           sum(coalesce(b.quantity_on_hand, 0) - coalesce(b.quantity_reserved, 0) - coalesce(b.quantity_allocated, 0)) as aggregate_available\n    from wms_inventory_balances b\n    where b.organization_id = ? and b.tenant_id = ? and ${variantClause.sql} and b.deleted_at is null\n      ${locationClause}\n    group by b.catalog_variant_id\n  `\n  const rows = await em.getConnection().execute<BalanceAggregateRow[]>(sql, params)\n  for (const row of rows) {\n    result.set(row.catalog_variant_id, Number(row.aggregate_available ?? 0))\n  }\n  return result\n}\n\nasync function loadProfiles(\n  em: EntityManager,\n  tenantId: string,\n  organizationId: string,\n  variantIds: string[],\n  productIds: string[],\n): Promise<ProfileRow[]> {\n  if (variantIds.length === 0 && productIds.length === 0) return []\n  const variantClause = buildSqlInClause('catalog_variant_id', variantIds)\n  const productClause = buildSqlInClause('catalog_product_id', productIds)\n  const sql = `\n    select catalog_product_id, catalog_variant_id, safety_stock, reorder_point\n    from wms_product_inventory_profiles\n    where organization_id = ? and tenant_id = ? and deleted_at is null\n      and (${variantClause.sql} or (${productClause.sql} and catalog_variant_id is null))\n  `\n  return em.getConnection().execute<ProfileRow[]>(sql, [\n    organizationId,\n    tenantId,\n    ...variantClause.params,\n    ...productClause.params,\n  ])\n}\n\nasync function loadActiveVariantsForProducts(\n  em: EntityManager,\n  tenantId: string,\n  organizationId: string,\n  productIds: string[],\n): Promise<VariantRow[]> {\n  if (productIds.length === 0) return []\n  const productClause = buildSqlInClause('product_id', productIds)\n  const sql = `\n    select id, product_id\n    from catalog_product_variants\n    where organization_id = ? and tenant_id = ? and ${productClause.sql} and is_active = true and deleted_at is null\n  `\n  return em.getConnection().execute<VariantRow[]>(sql, [organizationId, tenantId, ...productClause.params])\n}\n\nfunction findProfile(profiles: ProfileRow[], productId: string, variantId: string | null): ProfileRow | null {\n  if (variantId) {\n    const variantRow = profiles.find((p) => p.catalog_variant_id === variantId)\n    if (variantRow) return variantRow\n  }\n  return profiles.find((p) => p.catalog_product_id === productId && !p.catalog_variant_id) ?? null\n}\n\n/**\n * The open policy default used when `availability` is not installed. \u00A75.2:\n * `is_stock_managed` defaults to `true` only when a `ProductInventoryProfile`\n * exists for the item \u2014 an item without one is `not_tracked`, never\n * `out_of_stock`.\n */\nfunction openPolicyDefaultFor(\n  profiles: ProfileRow[],\n  productId: string,\n  variantId: string | null,\n): ResolvedPolicyOverlay {\n  const hasProfile = findProfile(profiles, productId, variantId) !== null\n  return { ...OPEN_POLICY_DEFAULT, isStockManaged: { value: hasProfile, policySourceId: null } }\n}\n\nfunction computeState(params: {\n  sellable: number\n  requested: number\n  lowStockThreshold: number | null\n  allowBackorder: boolean\n  backorderLeadTimeDays: number | null\n  preorderReleaseAt: Date | null\n  isActive: boolean\n}): { state: AvailabilityState; canFulfil: boolean; leadTimeDays: number | null; releaseAt: string | null } {\n  if (!params.isActive) {\n    return { state: 'out_of_stock', canFulfil: false, leadTimeDays: null, releaseAt: null }\n  }\n  if (params.preorderReleaseAt && params.preorderReleaseAt.getTime() > Date.now()) {\n    return { state: 'preorder', canFulfil: true, leadTimeDays: null, releaseAt: params.preorderReleaseAt.toISOString() }\n  }\n  if (params.sellable >= params.requested) {\n    const state: AvailabilityState =\n      params.lowStockThreshold != null && params.sellable <= params.lowStockThreshold ? 'low_stock' : 'in_stock'\n    return { state, canFulfil: true, leadTimeDays: null, releaseAt: null }\n  }\n  if (params.allowBackorder) {\n    return { state: 'backorder', canFulfil: true, leadTimeDays: params.backorderLeadTimeDays, releaseAt: null }\n  }\n  return { state: 'out_of_stock', canFulfil: false, leadTimeDays: null, releaseAt: null }\n}\n\n/**\n * Order-quantity rules (\u00A75.1) are a cap independent of stock: a violation\n * blocks fulfilment without changing the stock-derived state.\n */\nfunction isWithinOrderQuantityRules(requested: number, policy: ResolvedPolicyOverlay): boolean {\n  const min = policy.minOrderQuantity.value\n  const max = policy.maxOrderQuantity.value\n  const increment = policy.quantityIncrement.value\n  if (min != null && requested < min) return false\n  if (max != null && requested > max) return false\n  if (increment != null && increment > 0 && requested % increment !== 0) return false\n  return true\n}\n\n/**\n * Mirrors the catalog-only fallback's precedence (inactive \u2192 preorder \u2192\n * not_tracked) for an item the policy excludes from stock tracking. An inactive\n * policy makes the item unpurchasable before any preorder date, exactly as on the\n * tracked path (`computeState`).\n */\nfunction computeUntrackedItem(policy: ResolvedPolicyOverlay): AvailabilityItemResult {\n  const base: AvailabilityItemResult = {\n    state: 'not_tracked',\n    availableQuantity: null,\n    canFulfil: true,\n    leadTimeDays: null,\n    releaseAt: null,\n    isAuthoritative: true,\n    policySourceId: policy.isStockManaged.policySourceId,\n  }\n  if (!policy.isActive.value) {\n    return { ...base, state: 'out_of_stock', canFulfil: false, policySourceId: policy.isActive.policySourceId }\n  }\n  const preorderReleaseAt = policy.preorderReleaseAt.value\n  if (preorderReleaseAt && preorderReleaseAt.getTime() > Date.now()) {\n    return {\n      ...base,\n      state: 'preorder',\n      releaseAt: preorderReleaseAt.toISOString(),\n      policySourceId: policy.preorderReleaseAt.policySourceId,\n    }\n  }\n  return base\n}\n\n/**\n * Computes availability for a batch of items \u2014 always live, never cached\n * (the cache wrapper lives in `availabilityCache.ts`, Phase 2 Step 3.2).\n */\nexport async function computeAvailability(\n  em: EntityManager,\n  container: Resolver,\n  query: AvailabilityQuery,\n): Promise<AvailabilityResult> {\n  const byItem: AvailabilityResult['byItem'] = {}\n  if (query.items.length === 0) return { byItem }\n\n  const variantItems = query.items.filter((item) => !!item.catalogVariantId)\n  const productItems = query.items.filter((item) => !item.catalogVariantId)\n  const productItemIds = Array.from(new Set(productItems.map((item) => item.catalogProductId)))\n\n  // One batched lookup of active variants for every product-level item (R4).\n  const rollupVariantRows = await loadActiveVariantsForProducts(em, query.tenantId, query.organizationId, productItemIds)\n  const variantsByProduct = new Map<string, string[]>()\n  for (const row of rollupVariantRows) {\n    const list = variantsByProduct.get(row.product_id) ?? []\n    list.push(row.id)\n    variantsByProduct.set(row.product_id, list)\n  }\n\n  const allVariantIds = Array.from(\n    new Set([\n      ...variantItems.map((item) => item.catalogVariantId as string),\n      ...rollupVariantRows.map((row) => row.id),\n    ]),\n  )\n  const allProductIds = Array.from(new Set(query.items.map((item) => item.catalogProductId)))\n\n  // One balance aggregation and one profile lookup for the whole batch (R4).\n  const [balances, profiles] = await Promise.all([\n    loadBalanceAggregates(em, query.tenantId, query.organizationId, allVariantIds, query.locationIds),\n    loadProfiles(em, query.tenantId, query.organizationId, allVariantIds, allProductIds),\n  ])\n\n  // One batched policy resolution for the whole batch (R4).\n  const policyService = tryResolve<PolicyResolutionServiceLike>(container, 'policyResolutionService')\n  const policyScopes: PolicyResolutionScopeLike[] = query.items.map((item) => ({\n    tenantId: query.tenantId,\n    organizationId: query.organizationId,\n    storeId: query.storeId ?? null,\n    productId: item.catalogProductId,\n    variantId: item.catalogVariantId ?? null,\n  }))\n  const resolvedPolicies = policyService\n    ? await policyService.resolveMany(em, policyScopes)\n    : query.items.map((item) => openPolicyDefaultFor(profiles, item.catalogProductId, item.catalogVariantId ?? null))\n\n  function sellableFor(variantId: string, productId: string): number {\n    const aggregate = balances.get(variantId) ?? 0\n    const profile = findProfile(profiles, productId, variantId)\n    const safetyStock = profile ? Number(profile.safety_stock ?? 0) : 0\n    return Math.max(0, aggregate - safetyStock)\n  }\n\n  query.items.forEach((item, index) => {\n    const policy =\n      resolvedPolicies[index]\n      ?? openPolicyDefaultFor(profiles, item.catalogProductId, item.catalogVariantId ?? null)\n    const key = availabilityItemKey(item)\n    const withinOrderQuantityRules = isWithinOrderQuantityRules(item.quantity, policy)\n\n    if (!policy.isStockManaged.value) {\n      const untracked = computeUntrackedItem(policy)\n      byItem[key] = { ...untracked, canFulfil: untracked.canFulfil && withinOrderQuantityRules }\n      return\n    }\n\n    let sellable: number\n    let reorderPoint: number | null = null\n    if (item.catalogVariantId) {\n      sellable = sellableFor(item.catalogVariantId, item.catalogProductId)\n      const profile = findProfile(profiles, item.catalogProductId, item.catalogVariantId)\n      reorderPoint = profile && profile.reorder_point != null ? Number(profile.reorder_point) : null\n    } else {\n      const variantIds = variantsByProduct.get(item.catalogProductId) ?? []\n      sellable = variantIds.reduce((sum, variantId) => sum + sellableFor(variantId, item.catalogProductId), 0)\n      const profile = findProfile(profiles, item.catalogProductId, null)\n      reorderPoint = profile && profile.reorder_point != null ? Number(profile.reorder_point) : null\n    }\n\n    const effectiveLowStockThreshold = policy.lowStockThreshold.value ?? reorderPoint\n\n    const computed = computeState({\n      sellable,\n      requested: item.quantity,\n      lowStockThreshold: effectiveLowStockThreshold,\n      allowBackorder: policy.allowBackorder.value,\n      backorderLeadTimeDays: policy.backorderLeadTimeDays.value,\n      preorderReleaseAt: policy.preorderReleaseAt.value,\n      isActive: policy.isActive.value,\n    })\n\n    byItem[key] = {\n      state: computed.state,\n      availableQuantity: sellable,\n      canFulfil: computed.canFulfil && withinOrderQuantityRules,\n      leadTimeDays: computed.leadTimeDays,\n      releaseAt: computed.releaseAt,\n      isAuthoritative: true,\n      policySourceId: policy.isStockManaged.policySourceId,\n    }\n  })\n\n  return { byItem }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/wms/lib/availabilityProvider.js

@@ -0,0 +1,24 @@
+import { computeAvailabilityCached } from "./availabilityCache.js";
+const WMS_AVAILABILITY_PROVIDER_ID = "wms";
+async function createDefaultContainer() {
+  const { createRequestContainer } = await import("@open-mercato/shared/lib/di/container");
+  return createRequestContainer();
+}
+function createWmsAvailabilityProvider(options = {}) {
+  const createContainer = options.createContainer ?? createDefaultContainer;
+  return {
+    id: WMS_AVAILABILITY_PROVIDER_ID,
+    async getAvailability(query, context) {
+      const container = context?.container ?? await createContainer();
+      const em = container.resolve("em").fork();
+      return computeAvailabilityCached(em, container, query);
+    }
+  };
+}
+const wmsAvailabilityProvider = createWmsAvailabilityProvider();
+export {
+  WMS_AVAILABILITY_PROVIDER_ID,
+  createWmsAvailabilityProvider,
+  wmsAvailabilityProvider
+};
+//# sourceMappingURL=availabilityProvider.js.map

package/dist/modules/wms/lib/availabilityProvider.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/availabilityProvider.ts"],
+  "sourcesContent": ["/**\n * `wms`'s `AvailabilityProvider` registration (`id: 'wms'`).\n *\n * @see .ai/specs/2026-08-14-availability-contract.md \u00A73.1, \u00A74.2\n *\n * The shared registry is process-wide, while `wms/di.ts`'s `register()` runs\n * once per `createRequestContainer()` call. The provider therefore captures\n * no container: every `getAvailability()` call resolves `em`, the cache and\n * the policy service from the calling request's container\n * (`context.container`), or builds a fresh request container when the caller\n * passed none. A request can never reach another request's container.\n */\n\nimport type { EntityManager } from '@mikro-orm/postgresql'\nimport type {\n  AvailabilityDependencyResolver,\n  AvailabilityProvider,\n  AvailabilityProviderContext,\n  AvailabilityQuery,\n  AvailabilityResult,\n} from '@open-mercato/shared/lib/availability'\nimport { computeAvailabilityCached } from './availabilityCache'\n\nexport const WMS_AVAILABILITY_PROVIDER_ID = 'wms'\n\nexport type WmsAvailabilityProviderOptions = {\n  createContainer?: () => Promise<AvailabilityDependencyResolver>\n}\n\nasync function createDefaultContainer(): Promise<AvailabilityDependencyResolver> {\n  const { createRequestContainer } = await import('@open-mercato/shared/lib/di/container')\n  return createRequestContainer()\n}\n\nexport function createWmsAvailabilityProvider(options: WmsAvailabilityProviderOptions = {}): AvailabilityProvider {\n  const createContainer = options.createContainer ?? createDefaultContainer\n  return {\n    id: WMS_AVAILABILITY_PROVIDER_ID,\n    async getAvailability(query: AvailabilityQuery, context?: AvailabilityProviderContext): Promise<AvailabilityResult> {\n      const container = context?.container ?? (await createContainer())\n      const em = container.resolve<EntityManager>('em').fork()\n      return computeAvailabilityCached(em, container, query)\n    },\n  }\n}\n\nexport const wmsAvailabilityProvider: AvailabilityProvider = createWmsAvailabilityProvider()\n"],
+  "mappings": "AAqBA,SAAS,iCAAiC;AAEnC,MAAM,+BAA+B;AAM5C,eAAe,yBAAkE;AAC/E,QAAM,EAAE,uBAAuB,IAAI,MAAM,OAAO,uCAAuC;AACvF,SAAO,uBAAuB;AAChC;AAEO,SAAS,8BAA8B,UAA0C,CAAC,GAAyB;AAChH,QAAM,kBAAkB,QAAQ,mBAAmB;AACnD,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM,gBAAgB,OAA0B,SAAoE;AAClH,YAAM,YAAY,SAAS,aAAc,MAAM,gBAAgB;AAC/D,YAAM,KAAK,UAAU,QAAuB,IAAI,EAAE,KAAK;AACvD,aAAO,0BAA0B,IAAI,WAAW,KAAK;AAAA,IACvD;AAAA,EACF;AACF;AAEO,MAAM,0BAAgD,8BAA8B;",
+  "names": []
+}

package/dist/modules/wms/lib/loadOperationalDashboard.js

@@ -100,7 +100,21 @@ function buildExpiryLotRows(expiringSoonLots, pastDueLots, balances, warehouseId
   }));
   return [...expiringRows, ...pastDueRows];
 }
-function computeLowStockCounts(profiles, balances, warehouseId) {
+function resolveEffectiveProfilesByVariant(profiles, variantIdsByProduct = /* @__PURE__ */ new Map()) {
+  const effective = /* @__PURE__ */ new Map();
+  for (const profile of profiles) {
+    const variantId = profile.catalogVariantId;
+    if (variantId && !effective.has(variantId)) effective.set(variantId, profile);
+  }
+  for (const profile of profiles) {
+    if (profile.catalogVariantId) continue;
+    for (const variantId of variantIdsByProduct.get(profile.catalogProductId) ?? []) {
+      if (!effective.has(variantId)) effective.set(variantId, profile);
+    }
+  }
+  return effective;
+}
+function computeLowStockCounts(profiles, balances, warehouseId, variantIdsByProduct) {
   const availableByVariantWarehouse = /* @__PURE__ */ new Map();
   for (const balance of balances) {
     const onHand = toOperationalDashboardNumber(balance.quantityOnHand);
@@ -113,9 +127,7 @@ function computeLowStockCounts(profiles, balances, warehouseId) {
   let lowStockCount = 0;
   let reorderCriticalCount = 0;
   const seenLowStockKeys = /* @__PURE__ */ new Set();
-  for (const profile of profiles) {
-    const variantId = profile.catalogVariantId;
-    if (!variantId) continue;
+  for (const [variantId, profile] of resolveEffectiveProfilesByVariant(profiles, variantIdsByProduct)) {
     const reorderPoint = toOperationalDashboardNumber(profile.reorderPoint);
     const safetyStock = toOperationalDashboardNumber(profile.safetyStock);
     if (reorderPoint <= 0 && safetyStock <= 0) continue;
@@ -172,6 +184,28 @@ async function loadVariantSkus(em, scope, variantIds) {
   }
   return map;
 }
+async function loadVariantIdsForProductLevelProfiles(em, scope, profiles) {
+  const productIds = Array.from(
+    new Set(
+      profiles.filter((profile) => !profile.catalogVariantId && profile.catalogProductId).map((profile) => profile.catalogProductId)
+    )
+  );
+  if (productIds.length === 0) return /* @__PURE__ */ new Map();
+  const rows = await em.getConnection().execute(
+    `select id, product_id from catalog_product_variants
+     where organization_id = ? and tenant_id = ? and product_id in (${productIds.map(() => "?").join(", ")})
+     and is_active = true and deleted_at is null`,
+    [scope.organizationId, scope.tenantId, ...productIds]
+  );
+  const map = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    if (!row.id || !row.product_id) continue;
+    const variantIds = map.get(row.product_id) ?? [];
+    variantIds.push(row.id);
+    map.set(row.product_id, variantIds);
+  }
+  return map;
+}
 async function countMovementsBetween(em, scope, start, end, options) {
   const params = [scope.organizationId, scope.tenantId, start, end];
   let sql = `
@@ -453,10 +487,12 @@ async function loadOperationalDashboard(em, scope) {
       decryptionScope
     )
   ]);
+  const variantIdsByProduct = await loadVariantIdsForProductLevelProfiles(em, scope, profiles);
   const { lowStockCount, reorderCriticalCount } = computeLowStockCounts(
     profiles,
     balances,
-    scope.warehouseId
+    scope.warehouseId,
+    variantIdsByProduct
   );
   const expiringSoonCount = expiringSoonLots.filter(
     (lot) => resolveLotAvailableQuantity(lot.id, balances, scope.warehouseId) > 0
@@ -573,6 +609,7 @@ export {
   computeLowStockCounts,
   loadOperationalDashboard,
   mapDailyCountsToSparkline,
+  resolveEffectiveProfilesByVariant,
   resolveLotAvailableQuantity,
   startOfUtcDay2 as startOfUtcDay,
   toOperationalDashboardNumber