@open-mercato/core 0.6.7-develop.6661.1.0043ed1d03 → 0.6.7-develop.6670.1.4efa7961c6

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

@@ -0,0 +1,49 @@
+async function resolveLowStockVariantIds(em, scope, mode) {
+  const params = [scope.organizationId, scope.tenantId];
+  let warehouseJoin = "";
+  if (scope.warehouseId) {
+    warehouseJoin = " and b.warehouse_id = ?";
+    params.push(scope.warehouseId);
+  }
+  const thresholdExpr = mode === "belowSafety" ? "coalesce(p.safety_stock, 0)" : "coalesce(p.reorder_point, 0)";
+  const thresholdGuard = mode === "belowSafety" ? "coalesce(p.safety_stock, 0) > 0" : "(coalesce(p.reorder_point, 0) > 0 or coalesce(p.safety_stock, 0) > 0)";
+  params.push(scope.organizationId, scope.tenantId);
+  const sql = `
+    select distinct p.catalog_variant_id as catalog_variant_id
+    from wms_product_inventory_profiles p
+    join (
+      select
+        b.catalog_variant_id,
+        b.warehouse_id,
+        sum(
+          coalesce(b.quantity_on_hand, 0)
+          - coalesce(b.quantity_reserved, 0)
+          - coalesce(b.quantity_allocated, 0)
+        ) as available
+      from wms_inventory_balances b
+      where b.organization_id = ?
+        and b.tenant_id = ?
+        and b.deleted_at is null
+        ${warehouseJoin}
+      group by b.catalog_variant_id, b.warehouse_id
+    ) availability
+      on availability.catalog_variant_id = p.catalog_variant_id
+    where p.organization_id = ?
+      and p.tenant_id = ?
+      and p.deleted_at is null
+      and p.catalog_variant_id is not null
+      and ${thresholdGuard}
+      and availability.available <= ${thresholdExpr}
+  `;
+  const rows = await em.getConnection().execute(sql, params);
+  return rows.map((row) => row.catalog_variant_id?.trim()).filter((value) => Boolean(value));
+}
+const NO_MATCH_UUID = "00000000-0000-4000-8000-000000000000";
+function formatLowStockVariantIdsForFilter(variantIds) {
+  return variantIds.length > 0 ? variantIds : [NO_MATCH_UUID];
+}
+export {
+  formatLowStockVariantIdsForFilter,
+  resolveLowStockVariantIds
+};
+//# sourceMappingURL=lowStockBalanceFilter.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/lowStockBalanceFilter.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\n\nexport type LowStockBalanceFilterMode = 'belowReorder' | 'belowSafety'\n\ntype LowStockScope = {\n  organizationId: string\n  tenantId: string\n  warehouseId?: string | null\n}\n\nexport async function resolveLowStockVariantIds(\n  em: EntityManager,\n  scope: LowStockScope,\n  mode: LowStockBalanceFilterMode,\n): Promise<string[]> {\n  const params: unknown[] = [scope.organizationId, scope.tenantId]\n  let warehouseJoin = ''\n  if (scope.warehouseId) {\n    warehouseJoin = ' and b.warehouse_id = ?'\n    params.push(scope.warehouseId)\n  }\n\n  const thresholdExpr =\n    mode === 'belowSafety'\n      ? 'coalesce(p.safety_stock, 0)'\n      : 'coalesce(p.reorder_point, 0)'\n\n  const thresholdGuard =\n    mode === 'belowSafety'\n      ? 'coalesce(p.safety_stock, 0) > 0'\n      : '(coalesce(p.reorder_point, 0) > 0 or coalesce(p.safety_stock, 0) > 0)'\n\n  params.push(scope.organizationId, scope.tenantId)\n\n  const sql = `\n    select distinct p.catalog_variant_id as catalog_variant_id\n    from wms_product_inventory_profiles p\n    join (\n      select\n        b.catalog_variant_id,\n        b.warehouse_id,\n        sum(\n          coalesce(b.quantity_on_hand, 0)\n          - coalesce(b.quantity_reserved, 0)\n          - coalesce(b.quantity_allocated, 0)\n        ) as available\n      from wms_inventory_balances b\n      where b.organization_id = ?\n        and b.tenant_id = ?\n        and b.deleted_at is null\n        ${warehouseJoin}\n      group by b.catalog_variant_id, b.warehouse_id\n    ) availability\n      on availability.catalog_variant_id = p.catalog_variant_id\n    where p.organization_id = ?\n      and p.tenant_id = ?\n      and p.deleted_at is null\n      and p.catalog_variant_id is not null\n      and ${thresholdGuard}\n      and availability.available <= ${thresholdExpr}\n  `\n\n  const rows = await em.getConnection().execute<Array<{ catalog_variant_id: string }>>(sql, params)\n  return rows\n    .map((row) => row.catalog_variant_id?.trim())\n    .filter((value): value is string => Boolean(value))\n}\n\n/** Sentinel UUID that never matches a real entity \u2014 forces zero results when a low-stock filter returns an empty variant set. */\nconst NO_MATCH_UUID = '00000000-0000-4000-8000-000000000000'\n\nexport function formatLowStockVariantIdsForFilter(variantIds: string[]): string[] {\n  return variantIds.length > 0 ? variantIds : [NO_MATCH_UUID]\n}\n"],
+  "mappings": "AAUA,eAAsB,0BACpB,IACA,OACA,MACmB;AACnB,QAAM,SAAoB,CAAC,MAAM,gBAAgB,MAAM,QAAQ;AAC/D,MAAI,gBAAgB;AACpB,MAAI,MAAM,aAAa;AACrB,oBAAgB;AAChB,WAAO,KAAK,MAAM,WAAW;AAAA,EAC/B;AAEA,QAAM,gBACJ,SAAS,gBACL,gCACA;AAEN,QAAM,iBACJ,SAAS,gBACL,oCACA;AAEN,SAAO,KAAK,MAAM,gBAAgB,MAAM,QAAQ;AAEhD,QAAM,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAgBJ,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAQX,cAAc;AAAA,sCACY,aAAa;AAAA;AAGjD,QAAM,OAAO,MAAM,GAAG,cAAc,EAAE,QAA+C,KAAK,MAAM;AAChG,SAAO,KACJ,IAAI,CAAC,QAAQ,IAAI,oBAAoB,KAAK,CAAC,EAC3C,OAAO,CAAC,UAA2B,QAAQ,KAAK,CAAC;AACtD;AAGA,MAAM,gBAAgB;AAEf,SAAS,kCAAkC,YAAgC;AAChF,SAAO,WAAW,SAAS,IAAI,aAAa,CAAC,aAAa;AAC5D;",
+  "names": []
+}

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

@@ -0,0 +1,32 @@
+import { findOneWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { Warehouse } from "../data/entities.js";
+async function resolvePrimaryWarehouseId(em, scope) {
+  const warehouse = await findOneWithDecryption(
+    em,
+    Warehouse,
+    {
+      organizationId: scope.organizationId,
+      isPrimary: true,
+      isActive: true,
+      deletedAt: null
+    },
+    void 0,
+    scope
+  );
+  return warehouse?.id ?? null;
+}
+function sortWarehouseAvailabilityForReservation(warehouses, primaryWarehouseId) {
+  return [...warehouses].sort((left, right) => {
+    if (primaryWarehouseId) {
+      const leftPrimary = left.warehouseId === primaryWarehouseId ? 1 : 0;
+      const rightPrimary = right.warehouseId === primaryWarehouseId ? 1 : 0;
+      if (leftPrimary !== rightPrimary) return rightPrimary - leftPrimary;
+    }
+    return right.available - left.available;
+  });
+}
+export {
+  resolvePrimaryWarehouseId,
+  sortWarehouseAvailabilityForReservation
+};
+//# sourceMappingURL=primaryWarehousePolicy.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/primaryWarehousePolicy.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { Warehouse } from '../data/entities'\n\ntype Scope = {\n  tenantId: string\n  organizationId: string\n}\n\nexport type WarehouseAvailability = {\n  warehouseId: string\n  available: number\n}\n\nexport async function resolvePrimaryWarehouseId(\n  em: EntityManager,\n  scope: Scope,\n): Promise<string | null> {\n  const warehouse = await findOneWithDecryption(\n    em,\n    Warehouse,\n    {\n      organizationId: scope.organizationId,\n      isPrimary: true,\n      isActive: true,\n      deletedAt: null,\n    },\n    undefined,\n    scope,\n  )\n  return warehouse?.id ?? null\n}\n\nexport function sortWarehouseAvailabilityForReservation(\n  warehouses: WarehouseAvailability[],\n  primaryWarehouseId: string | null,\n): WarehouseAvailability[] {\n  return [...warehouses].sort((left, right) => {\n    if (primaryWarehouseId) {\n      const leftPrimary = left.warehouseId === primaryWarehouseId ? 1 : 0\n      const rightPrimary = right.warehouseId === primaryWarehouseId ? 1 : 0\n      if (leftPrimary !== rightPrimary) return rightPrimary - leftPrimary\n    }\n    return right.available - left.available\n  })\n}\n"],
+  "mappings": "AACA,SAAS,6BAA6B;AACtC,SAAS,iBAAiB;AAY1B,eAAsB,0BACpB,IACA,OACwB;AACxB,QAAM,YAAY,MAAM;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,MACE,gBAAgB,MAAM;AAAA,MACtB,WAAW;AAAA,MACX,UAAU;AAAA,MACV,WAAW;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACA,SAAO,WAAW,MAAM;AAC1B;AAEO,SAAS,wCACd,YACA,oBACyB;AACzB,SAAO,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,MAAM,UAAU;AAC3C,QAAI,oBAAoB;AACtB,YAAM,cAAc,KAAK,gBAAgB,qBAAqB,IAAI;AAClE,YAAM,eAAe,MAAM,gBAAgB,qBAAqB,IAAI;AACpE,UAAI,gBAAgB,aAAc,QAAO,eAAe;AAAA,IAC1D;AACA,WAAO,MAAM,YAAY,KAAK;AAAA,EAChC,CAAC;AACH;",
+  "names": []
+}

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

@@ -0,0 +1,30 @@
+const WMS_OPERATOR_ROLE = "operator";
+const WMS_SUPERVISOR_ROLE = "supervisor";
+const WMS_CUSTOM_ROLE_NAMES = [WMS_OPERATOR_ROLE, WMS_SUPERVISOR_ROLE];
+const WMS_OPERATOR_FEATURES = [
+  "wms.view",
+  "wms.adjust_inventory",
+  "wms.receive_inventory",
+  "wms.cycle_count"
+];
+const WMS_MANAGE_FEATURES = [
+  "wms.manage_warehouses",
+  "wms.manage_zones",
+  "wms.manage_locations",
+  "wms.manage_inventory",
+  "wms.manage_reservations"
+];
+const WMS_SUPERVISOR_FEATURES = [
+  ...WMS_OPERATOR_FEATURES,
+  "wms.import",
+  ...WMS_MANAGE_FEATURES
+];
+export {
+  WMS_CUSTOM_ROLE_NAMES,
+  WMS_MANAGE_FEATURES,
+  WMS_OPERATOR_FEATURES,
+  WMS_OPERATOR_ROLE,
+  WMS_SUPERVISOR_FEATURES,
+  WMS_SUPERVISOR_ROLE
+};
+//# sourceMappingURL=roleFeatures.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/roleFeatures.ts"],
+  "sourcesContent": ["/**\n * Reserved tenant role names seeded by WMS `setup.ts` via `ensureRoles`.\n * Other modules MUST NOT reuse `operator` or `supervisor` without coordinating ACL grants and i18n labels.\n */\nexport const WMS_OPERATOR_ROLE = 'operator' as const\nexport const WMS_SUPERVISOR_ROLE = 'supervisor' as const\n\nexport const WMS_CUSTOM_ROLE_NAMES = [WMS_OPERATOR_ROLE, WMS_SUPERVISOR_ROLE] as const\n\nexport const WMS_OPERATOR_FEATURES = [\n  'wms.view',\n  'wms.adjust_inventory',\n  'wms.receive_inventory',\n  'wms.cycle_count',\n] as const\n\nexport const WMS_MANAGE_FEATURES = [\n  'wms.manage_warehouses',\n  'wms.manage_zones',\n  'wms.manage_locations',\n  'wms.manage_inventory',\n  'wms.manage_reservations',\n] as const\n\nexport const WMS_SUPERVISOR_FEATURES = [\n  ...WMS_OPERATOR_FEATURES,\n  'wms.import',\n  ...WMS_MANAGE_FEATURES,\n] as const\n\nexport type WmsOperatorFeature = (typeof WMS_OPERATOR_FEATURES)[number]\nexport type WmsSupervisorFeature = (typeof WMS_SUPERVISOR_FEATURES)[number]\n"],
+  "mappings": "AAIO,MAAM,oBAAoB;AAC1B,MAAM,sBAAsB;AAE5B,MAAM,wBAAwB,CAAC,mBAAmB,mBAAmB;AAErE,MAAM,wBAAwB;AAAA,EACnC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,sBAAsB;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,MAAM,0BAA0B;AAAA,EACrC,GAAG;AAAA,EACH;AAAA,EACA,GAAG;AACL;",
+  "names": []
+}

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

@@ -0,0 +1,291 @@
+import { CrudHttpError } from "@open-mercato/shared/lib/crud/errors";
+import { findWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { E } from "../../../generated/entities.ids.generated.js";
+import { InventoryBalance, InventoryReservation } from "../data/entities.js";
+import { emitWmsEvent } from "../events.js";
+import { loadExplicitWarehouseIdForOrder } from "./salesOrderWarehouseAssignment.js";
+import {
+  resolvePrimaryWarehouseId,
+  sortWarehouseAvailabilityForReservation
+} from "./primaryWarehousePolicy.js";
+import { resolveWmsIntegrationToggleEnabled } from "./wmsIntegrationToggles.js";
+function isInsufficientStockError(error) {
+  return error instanceof CrudHttpError && error.status === 409 && error.body?.error === "insufficient_stock";
+}
+function isBalanceIntegrityViolationError(error) {
+  return error instanceof CrudHttpError && error.status === 409 && error.body?.error === "balance_integrity_violation";
+}
+function toNumber(value) {
+  if (typeof value === "number" && Number.isFinite(value)) return value;
+  if (typeof value === "string" && value.trim().length > 0) {
+    const parsed = Number(value);
+    if (Number.isFinite(parsed)) return parsed;
+  }
+  return 0;
+}
+function getWarehouseId(balance) {
+  const relation = balance.warehouse;
+  if (typeof relation === "string") return relation;
+  return typeof relation?.id === "string" ? relation.id : null;
+}
+function buildCommandContext(ctx, scope) {
+  return {
+    container: {
+      resolve: ctx.resolve
+    },
+    auth: null,
+    organizationScope: null,
+    selectedOrganizationId: scope.organizationId,
+    organizationIds: [scope.organizationId]
+  };
+}
+async function isInventoryAutomationEnabled(ctx, tenantId) {
+  try {
+    const featureTogglesService = ctx.resolve("featureTogglesService");
+    const em = ctx.resolve("em");
+    return resolveWmsIntegrationToggleEnabled(
+      featureTogglesService,
+      em,
+      "wms_integration_sales_order_inventory",
+      tenantId
+    );
+  } catch {
+    return true;
+  }
+}
+async function loadOrderViaQueryEngine(ctx, orderId, scope) {
+  const queryEngine = ctx.resolve("queryEngine");
+  const result = await queryEngine.query(E.sales.sales_order, {
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    filters: { id: { $eq: orderId } },
+    fields: ["id", "order_number", "tenant_id", "organization_id"],
+    page: { page: 1, pageSize: 1 }
+  });
+  return result.items[0] ?? null;
+}
+async function loadOrderLinesViaQueryEngine(ctx, orderId, scope) {
+  const queryEngine = ctx.resolve("queryEngine");
+  const result = await queryEngine.query(E.sales.sales_order_line, {
+    tenantId: scope.tenantId,
+    organizationId: scope.organizationId,
+    filters: { order_id: { $eq: orderId } },
+    fields: ["id", "kind", "product_variant_id", "quantity", "line_number"],
+    sort: [{ field: "line_number", dir: "asc" }],
+    page: { page: 1, pageSize: 1e3 }
+  });
+  return result.items;
+}
+async function loadActiveReservations(em, orderId, scope) {
+  return findWithDecryption(
+    em,
+    InventoryReservation,
+    {
+      sourceType: "order",
+      sourceId: orderId,
+      status: "active",
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId,
+      deletedAt: null
+    },
+    { orderBy: { createdAt: "asc" } },
+    scope
+  );
+}
+async function loadBalances(em, variantIds, scope) {
+  if (variantIds.length === 0) return [];
+  return findWithDecryption(
+    em,
+    InventoryBalance,
+    {
+      catalogVariantId: { $in: variantIds },
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId,
+      deletedAt: null
+    },
+    void 0,
+    scope
+  );
+}
+function buildRequiredQuantityByVariant(lines) {
+  const quantities = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    if (line.kind !== "product" || !line.product_variant_id) continue;
+    const quantity = toNumber(line.quantity);
+    if (quantity <= 0) continue;
+    quantities.set(
+      line.product_variant_id,
+      (quantities.get(line.product_variant_id) ?? 0) + quantity
+    );
+  }
+  return quantities;
+}
+function buildReservedQuantityByVariant(reservations) {
+  const quantities = /* @__PURE__ */ new Map();
+  for (const reservation of reservations) {
+    quantities.set(
+      reservation.catalogVariantId,
+      (quantities.get(reservation.catalogVariantId) ?? 0) + toNumber(reservation.quantity)
+    );
+  }
+  return quantities;
+}
+function buildWarehouseAvailability(balances) {
+  const byVariant = /* @__PURE__ */ new Map();
+  for (const balance of balances) {
+    const warehouseId = getWarehouseId(balance);
+    if (!warehouseId) continue;
+    const available = toNumber(balance.quantityOnHand) - toNumber(balance.quantityReserved) - toNumber(balance.quantityAllocated);
+    if (available <= 0) continue;
+    const warehouseMap = byVariant.get(balance.catalogVariantId) ?? /* @__PURE__ */ new Map();
+    warehouseMap.set(warehouseId, (warehouseMap.get(warehouseId) ?? 0) + available);
+    byVariant.set(balance.catalogVariantId, warehouseMap);
+  }
+  const result = /* @__PURE__ */ new Map();
+  for (const [variantId, warehouseMap] of byVariant.entries()) {
+    result.set(
+      variantId,
+      Array.from(warehouseMap.entries()).map(([warehouseId, available]) => ({ warehouseId, available }))
+    );
+  }
+  return result;
+}
+async function reserveInventoryForConfirmedOrder(payload, ctx) {
+  if (!payload.orderId || !payload.tenantId || !payload.organizationId) return;
+  if (!await isInventoryAutomationEnabled(ctx, payload.tenantId)) return;
+  const scope = {
+    tenantId: payload.tenantId,
+    organizationId: payload.organizationId
+  };
+  const em = ctx.resolve("em").fork();
+  const commandBus = ctx.resolve("commandBus");
+  const commandCtx = buildCommandContext(ctx, scope);
+  const order = await loadOrderViaQueryEngine(ctx, payload.orderId, scope);
+  if (!order || typeof order.id !== "string") return;
+  const orderId = order.id;
+  const orderNumber = typeof order.order_number === "string" ? order.order_number : null;
+  const [lines, activeReservations] = await Promise.all([
+    loadOrderLinesViaQueryEngine(ctx, orderId, scope),
+    loadActiveReservations(em, orderId, scope)
+  ]);
+  const requiredByVariant = buildRequiredQuantityByVariant(lines);
+  if (requiredByVariant.size === 0) return;
+  const reservedByVariant = buildReservedQuantityByVariant(activeReservations);
+  const balances = await loadBalances(em, Array.from(requiredByVariant.keys()), scope);
+  const availabilityByVariant = buildWarehouseAvailability(balances);
+  const [primaryWarehouseId, assignedWarehouseId] = await Promise.all([
+    resolvePrimaryWarehouseId(em, scope),
+    loadExplicitWarehouseIdForOrder(em, orderId, scope)
+  ]);
+  const preferredWarehouseId = assignedWarehouseId ?? primaryWarehouseId;
+  const shortfalls = [];
+  for (const [variantId, requiredQuantity] of requiredByVariant.entries()) {
+    let remainingQuantity = requiredQuantity - (reservedByVariant.get(variantId) ?? 0);
+    if (remainingQuantity <= 0) continue;
+    let variantBuckets = availabilityByVariant.get(variantId) ?? [];
+    if (assignedWarehouseId) {
+      variantBuckets = variantBuckets.filter(
+        (bucket) => bucket.warehouseId === assignedWarehouseId
+      );
+    }
+    const warehouseAvailability = sortWarehouseAvailabilityForReservation(
+      variantBuckets,
+      preferredWarehouseId
+    );
+    let reservedForVariant = 0;
+    try {
+      for (const bucket of warehouseAvailability) {
+        if (remainingQuantity <= 0) break;
+        const reserveQuantity = Math.min(remainingQuantity, bucket.available);
+        if (reserveQuantity <= 0) continue;
+        await commandBus.execute("wms.inventory.reserve", {
+          input: {
+            tenantId: scope.tenantId,
+            organizationId: scope.organizationId,
+            warehouseId: bucket.warehouseId,
+            catalogVariantId: variantId,
+            quantity: reserveQuantity,
+            sourceType: "order",
+            sourceId: orderId,
+            metadata: {
+              automation: "sales.order.confirmed",
+              orderId,
+              orderNumber,
+              catalogVariantId: variantId
+            }
+          },
+          ctx: commandCtx
+        });
+        remainingQuantity -= reserveQuantity;
+        reservedForVariant += reserveQuantity;
+        bucket.available -= reserveQuantity;
+      }
+    } catch (error) {
+      if (!isInsufficientStockError(error)) throw error;
+    }
+    if (remainingQuantity > 1e-6) {
+      shortfalls.push({
+        catalogVariantId: variantId,
+        requiredQuantity,
+        reservedQuantity: reservedForVariant + (reservedByVariant.get(variantId) ?? 0),
+        shortfallQuantity: remainingQuantity
+      });
+    }
+  }
+  if (shortfalls.length > 0) {
+    await emitWmsEvent("wms.inventory.reservation_shortfall", {
+      id: orderId,
+      orderId,
+      orderNumber,
+      shortfalls,
+      tenantId: scope.tenantId,
+      organizationId: scope.organizationId
+    });
+  }
+}
+async function releaseInventoryForCancelledOrder(payload, ctx) {
+  if (!payload.orderId || !payload.tenantId || !payload.organizationId) return;
+  if (!await isInventoryAutomationEnabled(ctx, payload.tenantId)) return;
+  const scope = {
+    tenantId: payload.tenantId,
+    organizationId: payload.organizationId
+  };
+  const em = ctx.resolve("em").fork();
+  const commandBus = ctx.resolve("commandBus");
+  const commandCtx = buildCommandContext(ctx, scope);
+  const activeReservations = await loadActiveReservations(em, payload.orderId, scope);
+  for (const reservation of activeReservations) {
+    try {
+      await commandBus.execute("wms.inventory.release", {
+        input: {
+          tenantId: scope.tenantId,
+          organizationId: scope.organizationId,
+          reservationId: reservation.id,
+          reason: "sales.order.cancelled",
+          metadata: {
+            automation: "sales.order.cancelled",
+            orderId: payload.orderId
+          }
+        },
+        ctx: commandCtx
+      });
+    } catch (error) {
+      if (!isBalanceIntegrityViolationError(error)) throw error;
+      void emitWmsEvent("wms.inventory.balance_drift", {
+        id: reservation.id,
+        balanceId: reservation.id,
+        reservationId: reservation.id,
+        field: "quantityReserved",
+        attemptedValue: null,
+        clampedValue: null,
+        tenantId: scope.tenantId,
+        organizationId: scope.organizationId
+      }).catch(() => void 0);
+    }
+  }
+}
+export {
+  releaseInventoryForCancelledOrder,
+  reserveInventoryForConfirmedOrder
+};
+//# sourceMappingURL=salesOrderInventoryAutomation.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/salesOrderInventoryAutomation.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { CommandBus, CommandRuntimeContext } from '@open-mercato/shared/lib/commands'\nimport { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'\nimport { findWithDecryption, findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport type { FeatureTogglesService } from '@open-mercato/core/modules/feature_toggles/lib/feature-flag-check'\nimport type { QueryEngine } from '@open-mercato/shared/lib/query/types'\nimport { E } from '#generated/entities.ids.generated'\nimport { InventoryBalance, InventoryReservation } from '../data/entities'\nimport { emitWmsEvent } from '../events'\nimport { loadExplicitWarehouseIdForOrder } from './salesOrderWarehouseAssignment'\nimport {\n  resolvePrimaryWarehouseId,\n  sortWarehouseAvailabilityForReservation,\n  type WarehouseAvailability,\n} from './primaryWarehousePolicy'\nimport { resolveWmsIntegrationToggleEnabled } from './wmsIntegrationToggles'\n\ntype EventContext = {\n  resolve: <T = unknown>(name: string) => T\n}\n\ntype SalesOrderLifecyclePayload = {\n  orderId?: string | null\n  tenantId?: string | null\n  organizationId?: string | null\n}\n\ntype Scope = {\n  tenantId: string\n  organizationId: string\n}\n\ntype ReservationShortfallLine = {\n  catalogVariantId: string\n  requiredQuantity: number\n  reservedQuantity: number\n  shortfallQuantity: number\n}\n\nfunction isInsufficientStockError(error: unknown): boolean {\n  return error instanceof CrudHttpError && error.status === 409 && error.body?.error === 'insufficient_stock'\n}\n\nfunction isBalanceIntegrityViolationError(error: unknown): boolean {\n  return error instanceof CrudHttpError && error.status === 409 && error.body?.error === 'balance_integrity_violation'\n}\n\ntype SalesOrderRow = {\n  id?: string\n  order_number?: string | null\n  tenant_id?: string | null\n  organization_id?: string | null\n}\n\ntype SalesOrderLineRow = {\n  id?: string\n  kind?: string | null\n  product_variant_id?: string | null\n  quantity?: string | number | null\n  line_number?: number | null\n}\n\nfunction toNumber(value: unknown): number {\n  if (typeof value === 'number' && Number.isFinite(value)) return value\n  if (typeof value === 'string' && value.trim().length > 0) {\n    const parsed = Number(value)\n    if (Number.isFinite(parsed)) return parsed\n  }\n  return 0\n}\n\nfunction getWarehouseId(balance: InventoryBalance): string | null {\n  const relation = balance.warehouse as { id?: string } | string | undefined\n  if (typeof relation === 'string') return relation\n  return typeof relation?.id === 'string' ? relation.id : null\n}\n\nfunction buildCommandContext(ctx: EventContext, scope: Scope): CommandRuntimeContext {\n  return {\n    container: {\n      resolve: ctx.resolve,\n    } as CommandRuntimeContext['container'],\n    auth: null,\n    organizationScope: null,\n    selectedOrganizationId: scope.organizationId,\n    organizationIds: [scope.organizationId],\n  }\n}\n\nasync function isInventoryAutomationEnabled(ctx: EventContext, tenantId: string): Promise<boolean> {\n  try {\n    const featureTogglesService = ctx.resolve<FeatureTogglesService>('featureTogglesService')\n    const em = ctx.resolve<EntityManager>('em')\n    return resolveWmsIntegrationToggleEnabled(\n      featureTogglesService,\n      em,\n      'wms_integration_sales_order_inventory',\n      tenantId,\n    )\n  } catch {\n    return true\n  }\n}\n\nasync function loadOrderViaQueryEngine(\n  ctx: EventContext,\n  orderId: string,\n  scope: Scope,\n): Promise<SalesOrderRow | null> {\n  // Read sales orders/lines via QueryEngine instead of importing the sales ORM\n  // entity classes \u2014 keeps the WMS module decoupled from sales internals.\n  // Sales mutations also flush their CRUD side effects synchronously through\n  // the command bus before this subscriber fires, so the query_index/base\n  // table is consistent at this point.\n  const queryEngine = ctx.resolve<QueryEngine>('queryEngine')\n  const result = await queryEngine.query<SalesOrderRow>(E.sales.sales_order, {\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    filters: { id: { $eq: orderId } },\n    fields: ['id', 'order_number', 'tenant_id', 'organization_id'],\n    page: { page: 1, pageSize: 1 },\n  })\n  return result.items[0] ?? null\n}\n\nasync function loadOrderLinesViaQueryEngine(\n  ctx: EventContext,\n  orderId: string,\n  scope: Scope,\n): Promise<SalesOrderLineRow[]> {\n  const queryEngine = ctx.resolve<QueryEngine>('queryEngine')\n  const result = await queryEngine.query<SalesOrderLineRow>(E.sales.sales_order_line, {\n    tenantId: scope.tenantId,\n    organizationId: scope.organizationId,\n    filters: { order_id: { $eq: orderId } },\n    fields: ['id', 'kind', 'product_variant_id', 'quantity', 'line_number'],\n    sort: [{ field: 'line_number', dir: 'asc' as never }],\n    page: { page: 1, pageSize: 1000 },\n  })\n  return result.items\n}\n\nasync function loadActiveReservations(\n  em: EntityManager,\n  orderId: string,\n  scope: Scope,\n): Promise<InventoryReservation[]> {\n  return findWithDecryption(\n    em,\n    InventoryReservation,\n    {\n      sourceType: 'order',\n      sourceId: orderId,\n      status: 'active',\n      tenantId: scope.tenantId,\n      organizationId: scope.organizationId,\n      deletedAt: null,\n    },\n    { orderBy: { createdAt: 'asc' } },\n    scope,\n  )\n}\n\nasync function loadBalances(\n  em: EntityManager,\n  variantIds: string[],\n  scope: Scope,\n): Promise<InventoryBalance[]> {\n  if (variantIds.length === 0) return []\n  return findWithDecryption(\n    em,\n    InventoryBalance,\n    {\n      catalogVariantId: { $in: variantIds },\n      tenantId: scope.tenantId,\n      organizationId: scope.organizationId,\n      deletedAt: null,\n    },\n    undefined,\n    scope,\n  )\n}\n\nfunction buildRequiredQuantityByVariant(lines: SalesOrderLineRow[]): Map<string, number> {\n  const quantities = new Map<string, number>()\n  for (const line of lines) {\n    if (line.kind !== 'product' || !line.product_variant_id) continue\n    const quantity = toNumber(line.quantity)\n    if (quantity <= 0) continue\n    quantities.set(\n      line.product_variant_id,\n      (quantities.get(line.product_variant_id) ?? 0) + quantity,\n    )\n  }\n  return quantities\n}\n\nfunction buildReservedQuantityByVariant(reservations: InventoryReservation[]): Map<string, number> {\n  const quantities = new Map<string, number>()\n  for (const reservation of reservations) {\n    quantities.set(\n      reservation.catalogVariantId,\n      (quantities.get(reservation.catalogVariantId) ?? 0) + toNumber(reservation.quantity),\n    )\n  }\n  return quantities\n}\n\nfunction buildWarehouseAvailability(\n  balances: InventoryBalance[],\n): Map<string, WarehouseAvailability[]> {\n  const byVariant = new Map<string, Map<string, number>>()\n  for (const balance of balances) {\n    const warehouseId = getWarehouseId(balance)\n    if (!warehouseId) continue\n    const available =\n      toNumber(balance.quantityOnHand) -\n      toNumber(balance.quantityReserved) -\n      toNumber(balance.quantityAllocated)\n    if (available <= 0) continue\n\n    const warehouseMap = byVariant.get(balance.catalogVariantId) ?? new Map<string, number>()\n    warehouseMap.set(warehouseId, (warehouseMap.get(warehouseId) ?? 0) + available)\n    byVariant.set(balance.catalogVariantId, warehouseMap)\n  }\n\n  const result = new Map<string, WarehouseAvailability[]>()\n  for (const [variantId, warehouseMap] of byVariant.entries()) {\n    result.set(\n      variantId,\n      Array.from(warehouseMap.entries()).map(([warehouseId, available]) => ({ warehouseId, available })),\n    )\n  }\n  return result\n}\n\nexport async function reserveInventoryForConfirmedOrder(\n  payload: SalesOrderLifecyclePayload,\n  ctx: EventContext,\n): Promise<void> {\n  if (!payload.orderId || !payload.tenantId || !payload.organizationId) return\n  if (!(await isInventoryAutomationEnabled(ctx, payload.tenantId))) return\n\n  const scope: Scope = {\n    tenantId: payload.tenantId,\n    organizationId: payload.organizationId,\n  }\n  const em = ctx.resolve<EntityManager>('em').fork()\n  const commandBus = ctx.resolve<CommandBus>('commandBus')\n  const commandCtx = buildCommandContext(ctx, scope)\n  const order = await loadOrderViaQueryEngine(ctx, payload.orderId, scope)\n  if (!order || typeof order.id !== 'string') return\n\n  const orderId = order.id\n  const orderNumber = typeof order.order_number === 'string' ? order.order_number : null\n\n  const [lines, activeReservations] = await Promise.all([\n    loadOrderLinesViaQueryEngine(ctx, orderId, scope),\n    loadActiveReservations(em, orderId, scope),\n  ])\n  const requiredByVariant = buildRequiredQuantityByVariant(lines)\n  if (requiredByVariant.size === 0) return\n\n  const reservedByVariant = buildReservedQuantityByVariant(activeReservations)\n  const balances = await loadBalances(em, Array.from(requiredByVariant.keys()), scope)\n  const availabilityByVariant = buildWarehouseAvailability(balances)\n  const [primaryWarehouseId, assignedWarehouseId] = await Promise.all([\n    resolvePrimaryWarehouseId(em, scope),\n    loadExplicitWarehouseIdForOrder(em, orderId, scope),\n  ])\n  const preferredWarehouseId = assignedWarehouseId ?? primaryWarehouseId\n  const shortfalls: ReservationShortfallLine[] = []\n\n  for (const [variantId, requiredQuantity] of requiredByVariant.entries()) {\n    let remainingQuantity = requiredQuantity - (reservedByVariant.get(variantId) ?? 0)\n    if (remainingQuantity <= 0) continue\n\n    let variantBuckets = availabilityByVariant.get(variantId) ?? []\n    if (assignedWarehouseId) {\n      variantBuckets = variantBuckets.filter(\n        (bucket) => bucket.warehouseId === assignedWarehouseId,\n      )\n    }\n\n    const warehouseAvailability = sortWarehouseAvailabilityForReservation(\n      variantBuckets,\n      preferredWarehouseId,\n    )\n    let reservedForVariant = 0\n    try {\n      for (const bucket of warehouseAvailability) {\n        if (remainingQuantity <= 0) break\n        const reserveQuantity = Math.min(remainingQuantity, bucket.available)\n        if (reserveQuantity <= 0) continue\n\n        await commandBus.execute('wms.inventory.reserve', {\n          input: {\n            tenantId: scope.tenantId,\n            organizationId: scope.organizationId,\n            warehouseId: bucket.warehouseId,\n            catalogVariantId: variantId,\n            quantity: reserveQuantity,\n            sourceType: 'order',\n            sourceId: orderId,\n            metadata: {\n              automation: 'sales.order.confirmed',\n              orderId,\n              orderNumber,\n              catalogVariantId: variantId,\n            },\n          },\n          ctx: commandCtx,\n        })\n\n        remainingQuantity -= reserveQuantity\n        reservedForVariant += reserveQuantity\n        bucket.available -= reserveQuantity\n      }\n    } catch (error) {\n      if (!isInsufficientStockError(error)) throw error\n    }\n\n    if (remainingQuantity > 0.000001) {\n      shortfalls.push({\n        catalogVariantId: variantId,\n        requiredQuantity,\n        reservedQuantity: reservedForVariant + (reservedByVariant.get(variantId) ?? 0),\n        shortfallQuantity: remainingQuantity,\n      })\n    }\n  }\n\n  if (shortfalls.length > 0) {\n    await emitWmsEvent('wms.inventory.reservation_shortfall', {\n      id: orderId,\n      orderId,\n      orderNumber,\n      shortfalls,\n      tenantId: scope.tenantId,\n      organizationId: scope.organizationId,\n    })\n  }\n}\n\nexport async function releaseInventoryForCancelledOrder(\n  payload: SalesOrderLifecyclePayload,\n  ctx: EventContext,\n): Promise<void> {\n  if (!payload.orderId || !payload.tenantId || !payload.organizationId) return\n  if (!(await isInventoryAutomationEnabled(ctx, payload.tenantId))) return\n\n  const scope: Scope = {\n    tenantId: payload.tenantId,\n    organizationId: payload.organizationId,\n  }\n  const em = ctx.resolve<EntityManager>('em').fork()\n  const commandBus = ctx.resolve<CommandBus>('commandBus')\n  const commandCtx = buildCommandContext(ctx, scope)\n  const activeReservations = await loadActiveReservations(em, payload.orderId, scope)\n\n  for (const reservation of activeReservations) {\n    try {\n      await commandBus.execute('wms.inventory.release', {\n        input: {\n          tenantId: scope.tenantId,\n          organizationId: scope.organizationId,\n          reservationId: reservation.id,\n          reason: 'sales.order.cancelled',\n          metadata: {\n            automation: 'sales.order.cancelled',\n            orderId: payload.orderId,\n          },\n        },\n        ctx: commandCtx,\n      })\n    } catch (error) {\n      if (!isBalanceIntegrityViolationError(error)) throw error\n      void emitWmsEvent('wms.inventory.balance_drift', {\n        id: reservation.id,\n        balanceId: reservation.id,\n        reservationId: reservation.id,\n        field: 'quantityReserved',\n        attemptedValue: null,\n        clampedValue: null,\n        tenantId: scope.tenantId,\n        organizationId: scope.organizationId,\n      }).catch(() => undefined)\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,54 @@
+import { findOneWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { SalesOrderWarehouseAssignment } from "../data/entities.js";
+function resolveWarehouseId(assignment) {
+  const warehouseRel = assignment.warehouse;
+  return typeof warehouseRel?.id === "string" ? warehouseRel.id : null;
+}
+async function loadExplicitWarehouseIdForOrder(em, salesOrderId, scope) {
+  const assignment = await findOneWithDecryption(
+    em,
+    SalesOrderWarehouseAssignment,
+    {
+      salesOrderId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    },
+    { populate: ["warehouse"] },
+    scope
+  );
+  if (!assignment) return null;
+  return resolveWarehouseId(assignment);
+}
+async function loadSalesOrderWarehouseAssignmentView(em, salesOrderId, scope) {
+  const assignment = await findOneWithDecryption(
+    em,
+    SalesOrderWarehouseAssignment,
+    {
+      salesOrderId,
+      organizationId: scope.organizationId,
+      tenantId: scope.tenantId,
+      deletedAt: null
+    },
+    { populate: ["warehouse"] },
+    scope
+  );
+  if (!assignment) return null;
+  const warehouseId = resolveWarehouseId(assignment);
+  if (!warehouseId) return null;
+  const warehouse = assignment.warehouse;
+  return {
+    id: assignment.id,
+    salesOrderId: assignment.salesOrderId,
+    warehouseId,
+    warehouseName: warehouse?.name ?? null,
+    warehouseCode: warehouse?.code ?? null,
+    notes: assignment.notes ?? null,
+    assignedBy: assignment.assignedBy ?? null
+  };
+}
+export {
+  loadExplicitWarehouseIdForOrder,
+  loadSalesOrderWarehouseAssignmentView
+};
+//# sourceMappingURL=salesOrderWarehouseAssignment.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/salesOrderWarehouseAssignment.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { SalesOrderWarehouseAssignment, Warehouse } from '../data/entities'\n\ntype Scope = {\n  tenantId: string\n  organizationId: string\n}\n\nexport type SalesOrderWarehouseAssignmentView = {\n  id: string\n  salesOrderId: string\n  warehouseId: string\n  warehouseName: string | null\n  warehouseCode: string | null\n  notes: string | null\n  assignedBy: string | null\n}\n\nfunction resolveWarehouseId(assignment: SalesOrderWarehouseAssignment): string | null {\n  const warehouseRel = assignment.warehouse as { id?: string } | undefined\n  return typeof warehouseRel?.id === 'string' ? warehouseRel.id : null\n}\n\nexport async function loadExplicitWarehouseIdForOrder(\n  em: EntityManager,\n  salesOrderId: string,\n  scope: Scope,\n): Promise<string | null> {\n  const assignment = await findOneWithDecryption(\n    em,\n    SalesOrderWarehouseAssignment,\n    {\n      salesOrderId,\n      organizationId: scope.organizationId,\n      tenantId: scope.tenantId,\n      deletedAt: null,\n    },\n    { populate: ['warehouse'] },\n    scope,\n  )\n  if (!assignment) return null\n  return resolveWarehouseId(assignment)\n}\n\nexport async function loadSalesOrderWarehouseAssignmentView(\n  em: EntityManager,\n  salesOrderId: string,\n  scope: Scope,\n): Promise<SalesOrderWarehouseAssignmentView | null> {\n  const assignment = await findOneWithDecryption(\n    em,\n    SalesOrderWarehouseAssignment,\n    {\n      salesOrderId,\n      organizationId: scope.organizationId,\n      tenantId: scope.tenantId,\n      deletedAt: null,\n    },\n    { populate: ['warehouse'] },\n    scope,\n  )\n  if (!assignment) return null\n\n  const warehouseId = resolveWarehouseId(assignment)\n  if (!warehouseId) return null\n\n  const warehouse = assignment.warehouse as Warehouse | undefined\n  return {\n    id: assignment.id,\n    salesOrderId: assignment.salesOrderId,\n    warehouseId,\n    warehouseName: warehouse?.name ?? null,\n    warehouseCode: warehouse?.code ?? null,\n    notes: assignment.notes ?? null,\n    assignedBy: assignment.assignedBy ?? null,\n  }\n}\n"],
+  "mappings": "AACA,SAAS,6BAA6B;AACtC,SAAS,qCAAgD;AAiBzD,SAAS,mBAAmB,YAA0D;AACpF,QAAM,eAAe,WAAW;AAChC,SAAO,OAAO,cAAc,OAAO,WAAW,aAAa,KAAK;AAClE;AAEA,eAAsB,gCACpB,IACA,cACA,OACwB;AACxB,QAAM,aAAa,MAAM;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,MACE;AAAA,MACA,gBAAgB,MAAM;AAAA,MACtB,UAAU,MAAM;AAAA,MAChB,WAAW;AAAA,IACb;AAAA,IACA,EAAE,UAAU,CAAC,WAAW,EAAE;AAAA,IAC1B;AAAA,EACF;AACA,MAAI,CAAC,WAAY,QAAO;AACxB,SAAO,mBAAmB,UAAU;AACtC;AAEA,eAAsB,sCACpB,IACA,cACA,OACmD;AACnD,QAAM,aAAa,MAAM;AAAA,IACvB;AAAA,IACA;AAAA,IACA;AAAA,MACE;AAAA,MACA,gBAAgB,MAAM;AAAA,MACtB,UAAU,MAAM;AAAA,MAChB,WAAW;AAAA,IACb;AAAA,IACA,EAAE,UAAU,CAAC,WAAW,EAAE;AAAA,IAC1B;AAAA,EACF;AACA,MAAI,CAAC,WAAY,QAAO;AAExB,QAAM,cAAc,mBAAmB,UAAU;AACjD,MAAI,CAAC,YAAa,QAAO;AAEzB,QAAM,YAAY,WAAW;AAC7B,SAAO;AAAA,IACL,IAAI,WAAW;AAAA,IACf,cAAc,WAAW;AAAA,IACzB;AAAA,IACA,eAAe,WAAW,QAAQ;AAAA,IAClC,eAAe,WAAW,QAAQ;AAAA,IAClC,OAAO,WAAW,SAAS;AAAA,IAC3B,YAAY,WAAW,cAAc;AAAA,EACvC;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,71 @@
+import { findOneWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { FeatureToggle } from "@open-mercato/core/modules/feature_toggles/data/entities";
+const WMS_INTEGRATION_TOGGLES = [
+  {
+    identifier: "wms_integration_sales_order_inventory",
+    name: "Sales Order Inventory Reservation",
+    description: "Allows WMS to reserve and release inventory from sales order lifecycle events.",
+    category: "wms",
+    type: "boolean",
+    defaultValue: true
+  },
+  {
+    identifier: "wms_integration_shipping_shipments",
+    name: "Shipping Shipment Coordination",
+    description: "Allows WMS to react to shipping shipment lifecycle events when shipment orchestration is enabled.",
+    category: "wms",
+    type: "boolean",
+    defaultValue: true
+  },
+  {
+    identifier: "wms_integration_procurement_goods_receipt",
+    name: "Procurement Goods Receipt Bridge",
+    description: "Reserved toggle for future procurement-driven receiving integration.",
+    category: "wms",
+    type: "boolean",
+    defaultValue: false
+  }
+];
+function findWmsIntegrationToggleDefinition(identifier) {
+  return WMS_INTEGRATION_TOGGLES.find((toggle) => toggle.identifier === identifier) ?? null;
+}
+async function seedWmsIntegrationToggles(em) {
+  for (const toggle of WMS_INTEGRATION_TOGGLES) {
+    const existing = await findOneWithDecryption(em, FeatureToggle, {
+      identifier: toggle.identifier,
+      deletedAt: null
+    });
+    if (existing) continue;
+    em.persist(
+      em.create(FeatureToggle, {
+        identifier: toggle.identifier,
+        name: toggle.name,
+        description: toggle.description,
+        category: toggle.category,
+        type: toggle.type,
+        defaultValue: toggle.defaultValue
+      })
+    );
+  }
+  await em.flush();
+}
+async function resolveWmsIntegrationToggleEnabled(featureTogglesService, em, identifier, tenantId) {
+  const definition = findWmsIntegrationToggleDefinition(identifier);
+  const fallback = definition?.defaultValue ?? true;
+  const result = await featureTogglesService.getBoolConfig(identifier, tenantId);
+  if (result.ok) return result.value;
+  if (result.error?.code !== "MISSING_TOGGLE" || !definition) {
+    return fallback;
+  }
+  await seedWmsIntegrationToggles(em);
+  await featureTogglesService.invalidateIsEnabledCacheByKey(identifier, tenantId);
+  const retried = await featureTogglesService.getBoolConfig(identifier, tenantId);
+  return retried.ok ? retried.value : fallback;
+}
+export {
+  WMS_INTEGRATION_TOGGLES,
+  findWmsIntegrationToggleDefinition,
+  resolveWmsIntegrationToggleEnabled,
+  seedWmsIntegrationToggles
+};
+//# sourceMappingURL=wmsIntegrationToggles.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/wmsIntegrationToggles.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport { FeatureToggle } from '@open-mercato/core/modules/feature_toggles/data/entities'\nimport type { FeatureTogglesService } from '@open-mercato/core/modules/feature_toggles/lib/feature-flag-check'\n\nexport const WMS_INTEGRATION_TOGGLES = [\n  {\n    identifier: 'wms_integration_sales_order_inventory',\n    name: 'Sales Order Inventory Reservation',\n    description: 'Allows WMS to reserve and release inventory from sales order lifecycle events.',\n    category: 'wms',\n    type: 'boolean' as const,\n    defaultValue: true,\n  },\n  {\n    identifier: 'wms_integration_shipping_shipments',\n    name: 'Shipping Shipment Coordination',\n    description: 'Allows WMS to react to shipping shipment lifecycle events when shipment orchestration is enabled.',\n    category: 'wms',\n    type: 'boolean' as const,\n    defaultValue: true,\n  },\n  {\n    identifier: 'wms_integration_procurement_goods_receipt',\n    name: 'Procurement Goods Receipt Bridge',\n    description: 'Reserved toggle for future procurement-driven receiving integration.',\n    category: 'wms',\n    type: 'boolean' as const,\n    defaultValue: false,\n  },\n] as const\n\nexport type WmsIntegrationToggleIdentifier = (typeof WMS_INTEGRATION_TOGGLES)[number]['identifier']\n\nexport function findWmsIntegrationToggleDefinition(identifier: string) {\n  return WMS_INTEGRATION_TOGGLES.find((toggle) => toggle.identifier === identifier) ?? null\n}\n\nexport async function seedWmsIntegrationToggles(em: EntityManager): Promise<void> {\n  for (const toggle of WMS_INTEGRATION_TOGGLES) {\n    const existing = await findOneWithDecryption(em, FeatureToggle, {\n      identifier: toggle.identifier,\n      deletedAt: null,\n    })\n    if (existing) continue\n    em.persist(\n      em.create(FeatureToggle, {\n        identifier: toggle.identifier,\n        name: toggle.name,\n        description: toggle.description,\n        category: toggle.category,\n        type: toggle.type,\n        defaultValue: toggle.defaultValue,\n      }),\n    )\n  }\n  await em.flush()\n}\n\nexport async function resolveWmsIntegrationToggleEnabled(\n  featureTogglesService: FeatureTogglesService,\n  em: EntityManager,\n  identifier: WmsIntegrationToggleIdentifier,\n  tenantId: string,\n): Promise<boolean> {\n  const definition = findWmsIntegrationToggleDefinition(identifier)\n  const fallback = definition?.defaultValue ?? true\n\n  const result = await featureTogglesService.getBoolConfig(identifier, tenantId)\n  if (result.ok) return result.value\n\n  if (result.error?.code !== 'MISSING_TOGGLE' || !definition) {\n    return fallback\n  }\n\n  await seedWmsIntegrationToggles(em)\n  await featureTogglesService.invalidateIsEnabledCacheByKey(identifier, tenantId)\n\n  const retried = await featureTogglesService.getBoolConfig(identifier, tenantId)\n  return retried.ok ? retried.value : fallback\n}\n"],
+  "mappings": "AACA,SAAS,6BAA6B;AACtC,SAAS,qBAAqB;AAGvB,MAAM,0BAA0B;AAAA,EACrC;AAAA,IACE,YAAY;AAAA,IACZ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM;AAAA,IACN,cAAc;AAAA,EAChB;AAAA,EACA;AAAA,IACE,YAAY;AAAA,IACZ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM;AAAA,IACN,cAAc;AAAA,EAChB;AAAA,EACA;AAAA,IACE,YAAY;AAAA,IACZ,MAAM;AAAA,IACN,aAAa;AAAA,IACb,UAAU;AAAA,IACV,MAAM;AAAA,IACN,cAAc;AAAA,EAChB;AACF;AAIO,SAAS,mCAAmC,YAAoB;AACrE,SAAO,wBAAwB,KAAK,CAAC,WAAW,OAAO,eAAe,UAAU,KAAK;AACvF;AAEA,eAAsB,0BAA0B,IAAkC;AAChF,aAAW,UAAU,yBAAyB;AAC5C,UAAM,WAAW,MAAM,sBAAsB,IAAI,eAAe;AAAA,MAC9D,YAAY,OAAO;AAAA,MACnB,WAAW;AAAA,IACb,CAAC;AACD,QAAI,SAAU;AACd,OAAG;AAAA,MACD,GAAG,OAAO,eAAe;AAAA,QACvB,YAAY,OAAO;AAAA,QACnB,MAAM,OAAO;AAAA,QACb,aAAa,OAAO;AAAA,QACpB,UAAU,OAAO;AAAA,QACjB,MAAM,OAAO;AAAA,QACb,cAAc,OAAO;AAAA,MACvB,CAAC;AAAA,IACH;AAAA,EACF;AACA,QAAM,GAAG,MAAM;AACjB;AAEA,eAAsB,mCACpB,uBACA,IACA,YACA,UACkB;AAClB,QAAM,aAAa,mCAAmC,UAAU;AAChE,QAAM,WAAW,YAAY,gBAAgB;AAE7C,QAAM,SAAS,MAAM,sBAAsB,cAAc,YAAY,QAAQ;AAC7E,MAAI,OAAO,GAAI,QAAO,OAAO;AAE7B,MAAI,OAAO,OAAO,SAAS,oBAAoB,CAAC,YAAY;AAC1D,WAAO;AAAA,EACT;AAEA,QAAM,0BAA0B,EAAE;AAClC,QAAM,sBAAsB,8BAA8B,YAAY,QAAQ;AAE9E,QAAM,UAAU,MAAM,sBAAsB,cAAc,YAAY,QAAQ;AAC9E,SAAO,QAAQ,KAAK,QAAQ,QAAQ;AACtC;",
+  "names": []
+}