@open-mercato/core 0.6.7-develop.6669.1.40b669666b → 0.6.7-develop.6670.1.4efa7961c6

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/catalogInventoryProfileIntent.ts"],
+  "sourcesContent": ["import { z } from 'zod'\n\nconst inventoryStrategySchema = z.enum(['fifo', 'lifo', 'fefo'])\n\nexport const catalogInventoryProfileIntentSchema = z.object({\n  manageInventory: z.boolean(),\n  defaultUom: z.string().trim().max(32).nullable().optional(),\n  defaultStrategy: inventoryStrategySchema.optional(),\n  trackLot: z.boolean().optional(),\n  trackSerial: z.boolean().optional(),\n  trackExpiration: z.boolean().optional(),\n  reorderPoint: z.coerce.number().finite().min(0).nullable().optional(),\n  safetyStock: z.coerce.number().finite().min(0).nullable().optional(),\n}).superRefine((payload, ctx) => {\n  if (!payload.manageInventory) return\n\n  if (!payload.defaultUom || payload.defaultUom.trim().length === 0) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: ['defaultUom'],\n      message: 'wms.widgets.catalog.inventoryProfile.errors.defaultUomRequired',\n    })\n  }\n\n  if (!payload.defaultStrategy) {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: ['defaultStrategy'],\n      message: 'wms.widgets.catalog.inventoryProfile.errors.strategyRequired',\n    })\n  }\n\n  if (payload.trackExpiration && payload.defaultStrategy !== 'fefo') {\n    ctx.addIssue({\n      code: z.ZodIssueCode.custom,\n      path: ['defaultStrategy'],\n      message: 'wms.widgets.catalog.inventoryProfile.errors.fefoRequired',\n    })\n  }\n})\n\nexport type CatalogInventoryProfileIntent = z.infer<\n  typeof catalogInventoryProfileIntentSchema\n>\n\nexport const WMS_CATALOG_PROFILE_HEADER =\n  'x-open-mercato-wms-catalog-profile'\n\nexport function encodeCatalogInventoryProfileIntent(\n  intent: CatalogInventoryProfileIntent,\n): string {\n  return encodeURIComponent(JSON.stringify(intent))\n}\n\nexport function decodeCatalogInventoryProfileIntent(\n  rawHeader: string | null | undefined,\n): CatalogInventoryProfileIntent | null {\n  if (typeof rawHeader !== 'string' || rawHeader.trim().length === 0) {\n    return null\n  }\n\n  const decoded = decodeURIComponent(rawHeader)\n  const parsed = JSON.parse(decoded) as unknown\n  return catalogInventoryProfileIntentSchema.parse(parsed)\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,MAAM,0BAA0B,EAAE,KAAK,CAAC,QAAQ,QAAQ,MAAM,CAAC;AAExD,MAAM,sCAAsC,EAAE,OAAO;AAAA,EAC1D,iBAAiB,EAAE,QAAQ;AAAA,EAC3B,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,SAAS;AAAA,EAC1D,iBAAiB,wBAAwB,SAAS;AAAA,EAClD,UAAU,EAAE,QAAQ,EAAE,SAAS;AAAA,EAC/B,aAAa,EAAE,QAAQ,EAAE,SAAS;AAAA,EAClC,iBAAiB,EAAE,QAAQ,EAAE,SAAS;AAAA,EACtC,cAAc,EAAE,OAAO,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS;AAAA,EACpE,aAAa,EAAE,OAAO,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS;AACrE,CAAC,EAAE,YAAY,CAAC,SAAS,QAAQ;AAC/B,MAAI,CAAC,QAAQ,gBAAiB;AAE9B,MAAI,CAAC,QAAQ,cAAc,QAAQ,WAAW,KAAK,EAAE,WAAW,GAAG;AACjE,QAAI,SAAS;AAAA,MACX,MAAM,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,YAAY;AAAA,MACnB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,MAAI,CAAC,QAAQ,iBAAiB;AAC5B,QAAI,SAAS;AAAA,MACX,MAAM,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,iBAAiB;AAAA,MACxB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,mBAAmB,QAAQ,oBAAoB,QAAQ;AACjE,QAAI,SAAS;AAAA,MACX,MAAM,EAAE,aAAa;AAAA,MACrB,MAAM,CAAC,iBAAiB;AAAA,MACxB,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AACF,CAAC;AAMM,MAAM,6BACX;AAEK,SAAS,oCACd,QACQ;AACR,SAAO,mBAAmB,KAAK,UAAU,MAAM,CAAC;AAClD;AAEO,SAAS,oCACd,WACsC;AACtC,MAAI,OAAO,cAAc,YAAY,UAAU,KAAK,EAAE,WAAW,GAAG;AAClE,WAAO;AAAA,EACT;AAEA,QAAM,UAAU,mBAAmB,SAAS;AAC5C,QAAM,SAAS,KAAK,MAAM,OAAO;AACjC,SAAO,oCAAoC,MAAM,MAAM;AACzD;",
+  "names": []
+}

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

@@ -0,0 +1,144 @@
+import { findOneWithDecryption } from "@open-mercato/shared/lib/encryption/find";
+import { E } from "../../../generated/entities.ids.generated.js";
+import { ProductInventoryProfile } from "../data/entities.js";
+import {
+  catalogInventoryProfileIntentSchema
+} from "./catalogInventoryProfileIntent.js";
+function normalizeOptionalString(value) {
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed.length > 0 ? trimmed : null;
+}
+function buildCommandContext(params) {
+  const auth = {
+    sub: params.userId,
+    userId: params.userId,
+    tenantId: params.tenantId,
+    orgId: params.organizationId
+  };
+  return {
+    container: params.container,
+    auth,
+    organizationScope: null,
+    selectedOrganizationId: params.organizationId,
+    organizationIds: [params.organizationId]
+  };
+}
+async function loadExistingProfile(params) {
+  const em = params.container.resolve("em");
+  const scope = {
+    organizationId: params.organizationId,
+    tenantId: params.tenantId
+  };
+  if (params.target === "variant") {
+    return findOneWithDecryption(
+      em,
+      ProductInventoryProfile,
+      {
+        organizationId: params.organizationId,
+        tenantId: params.tenantId,
+        deletedAt: null,
+        catalogVariantId: params.recordId
+      },
+      void 0,
+      scope
+    );
+  }
+  return findOneWithDecryption(
+    em,
+    ProductInventoryProfile,
+    {
+      organizationId: params.organizationId,
+      tenantId: params.tenantId,
+      deletedAt: null,
+      catalogProductId: params.catalogProductId,
+      catalogVariantId: null
+    },
+    void 0,
+    scope
+  );
+}
+async function resolveCatalogProductId(params) {
+  if (params.target === "product") return params.recordId;
+  const queryEngine = params.container.resolve("queryEngine");
+  const result = await queryEngine.query(
+    E.catalog.catalog_product_variant,
+    {
+      tenantId: params.tenantId,
+      organizationId: params.organizationId,
+      filters: { id: { $eq: params.recordId } },
+      fields: ["id", "product_id"],
+      page: { page: 1, pageSize: 1 }
+    }
+  );
+  const variantRow = result.items[0];
+  if (!variantRow) {
+    throw new Error(`Variant ${params.recordId} not found for WMS profile sync`);
+  }
+  const productId = typeof variantRow.product_id === "string" ? variantRow.product_id : null;
+  if (!productId) {
+    throw new Error(
+      `Variant ${params.recordId} is missing product context for WMS profile sync`
+    );
+  }
+  return productId;
+}
+async function syncCatalogInventoryProfile(input) {
+  const intent = catalogInventoryProfileIntentSchema.parse(input.intent);
+  const commandBus = input.container.resolve("commandBus");
+  const ctx = buildCommandContext(input);
+  const catalogProductId = await resolveCatalogProductId({
+    target: input.target,
+    recordId: input.recordId,
+    organizationId: input.organizationId,
+    tenantId: input.tenantId,
+    container: input.container
+  });
+  const existingProfile = await loadExistingProfile({
+    organizationId: input.organizationId,
+    tenantId: input.tenantId,
+    target: input.target,
+    recordId: input.recordId,
+    catalogProductId,
+    container: input.container
+  });
+  if (!intent.manageInventory) {
+    if (!existingProfile) return;
+    await commandBus.execute("wms.inventoryProfiles.delete", {
+      input: { id: existingProfile.id },
+      ctx
+    });
+    return;
+  }
+  const profileInput = {
+    organizationId: input.organizationId,
+    tenantId: input.tenantId,
+    catalogProductId,
+    catalogVariantId: input.target === "variant" ? input.recordId : null,
+    defaultUom: normalizeOptionalString(intent.defaultUom),
+    defaultStrategy: intent.defaultStrategy,
+    trackLot: intent.trackLot ?? false,
+    trackSerial: intent.trackSerial ?? false,
+    trackExpiration: intent.trackExpiration ?? false,
+    reorderPoint: intent.reorderPoint ?? 0,
+    safetyStock: intent.safetyStock ?? 0
+  };
+  if (existingProfile) {
+    await commandBus.execute("wms.inventoryProfiles.update", {
+      input: {
+        id: existingProfile.id,
+        ...profileInput
+      },
+      ctx
+    });
+    return;
+  }
+  await commandBus.execute("wms.inventoryProfiles.create", {
+    input: profileInput,
+    ctx
+  });
+}
+export {
+  syncCatalogInventoryProfile
+};
+//# sourceMappingURL=catalogInventoryProfileSync.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/catalogInventoryProfileSync.ts"],
+  "sourcesContent": ["import type { EntityManager } from '@mikro-orm/postgresql'\nimport type { AwilixContainer } from 'awilix'\nimport type { CommandBus, CommandRuntimeContext } from '@open-mercato/shared/lib/commands'\nimport { findOneWithDecryption } from '@open-mercato/shared/lib/encryption/find'\nimport type { AuthContext } from '@open-mercato/shared/lib/auth/server'\nimport type { QueryEngine } from '@open-mercato/shared/lib/query/types'\nimport { E } from '#generated/entities.ids.generated'\nimport { ProductInventoryProfile } from '../data/entities'\nimport {\n  catalogInventoryProfileIntentSchema,\n  type CatalogInventoryProfileIntent,\n} from './catalogInventoryProfileIntent'\n\ntype SyncTarget = 'product' | 'variant'\n\ntype SyncCatalogInventoryProfileInput = {\n  intent: CatalogInventoryProfileIntent\n  target: SyncTarget\n  recordId: string\n  organizationId: string\n  tenantId: string\n  userId: string\n  container: AwilixContainer\n}\n\nfunction normalizeOptionalString(value: unknown): string | null {\n  if (typeof value !== 'string') return null\n  const trimmed = value.trim()\n  return trimmed.length > 0 ? trimmed : null\n}\n\nfunction buildCommandContext(params: {\n  container: AwilixContainer\n  organizationId: string\n  tenantId: string\n  userId: string\n}): CommandRuntimeContext {\n  const auth: AuthContext = {\n    sub: params.userId,\n    userId: params.userId,\n    tenantId: params.tenantId,\n    orgId: params.organizationId,\n  }\n\n  return {\n    container: params.container,\n    auth,\n    organizationScope: null,\n    selectedOrganizationId: params.organizationId,\n    organizationIds: [params.organizationId],\n  }\n}\n\nasync function loadExistingProfile(params: {\n  organizationId: string\n  tenantId: string\n  target: SyncTarget\n  recordId: string\n  catalogProductId: string\n  container: AwilixContainer\n}) {\n  const em = params.container.resolve('em') as EntityManager\n  const scope = {\n    organizationId: params.organizationId,\n    tenantId: params.tenantId,\n  }\n\n  if (params.target === 'variant') {\n    return findOneWithDecryption(\n      em,\n      ProductInventoryProfile,\n      {\n        organizationId: params.organizationId,\n        tenantId: params.tenantId,\n        deletedAt: null,\n        catalogVariantId: params.recordId,\n      } as never,\n      undefined,\n      scope,\n    )\n  }\n\n  return findOneWithDecryption(\n    em,\n    ProductInventoryProfile,\n    {\n      organizationId: params.organizationId,\n      tenantId: params.tenantId,\n      deletedAt: null,\n      catalogProductId: params.catalogProductId,\n      catalogVariantId: null,\n    } as never,\n    undefined,\n    scope,\n  )\n}\n\nasync function resolveCatalogProductId(params: {\n  target: SyncTarget\n  recordId: string\n  organizationId: string\n  tenantId: string\n  container: AwilixContainer\n}): Promise<string> {\n  if (params.target === 'product') return params.recordId\n\n  // Read the variant -> product_id mapping via QueryEngine so this module does\n  // not import the catalog ORM entity directly. queryEngine resolves the\n  // base table via Mikro-ORM metadata, so the only cross-module surface we\n  // depend on is the public catalog entity id from the `E` registry.\n  const queryEngine = params.container.resolve('queryEngine') as QueryEngine\n  const result = await queryEngine.query<{ id?: string; product_id?: string }>(\n    E.catalog.catalog_product_variant,\n    {\n      tenantId: params.tenantId,\n      organizationId: params.organizationId,\n      filters: { id: { $eq: params.recordId } },\n      fields: ['id', 'product_id'],\n      page: { page: 1, pageSize: 1 },\n    },\n  )\n\n  const variantRow = result.items[0]\n  if (!variantRow) {\n    throw new Error(`Variant ${params.recordId} not found for WMS profile sync`)\n  }\n\n  const productId = typeof variantRow.product_id === 'string' ? variantRow.product_id : null\n  if (!productId) {\n    throw new Error(\n      `Variant ${params.recordId} is missing product context for WMS profile sync`,\n    )\n  }\n\n  return productId\n}\n\nexport async function syncCatalogInventoryProfile(\n  input: SyncCatalogInventoryProfileInput,\n): Promise<void> {\n  const intent = catalogInventoryProfileIntentSchema.parse(input.intent)\n  const commandBus = input.container.resolve('commandBus') as CommandBus\n  const ctx = buildCommandContext(input)\n  const catalogProductId = await resolveCatalogProductId({\n    target: input.target,\n    recordId: input.recordId,\n    organizationId: input.organizationId,\n    tenantId: input.tenantId,\n    container: input.container,\n  })\n\n  const existingProfile = await loadExistingProfile({\n    organizationId: input.organizationId,\n    tenantId: input.tenantId,\n    target: input.target,\n    recordId: input.recordId,\n    catalogProductId,\n    container: input.container,\n  })\n\n  if (!intent.manageInventory) {\n    if (!existingProfile) return\n    await commandBus.execute('wms.inventoryProfiles.delete', {\n      input: { id: existingProfile.id },\n      ctx,\n    })\n    return\n  }\n\n  const profileInput = {\n    organizationId: input.organizationId,\n    tenantId: input.tenantId,\n    catalogProductId,\n    catalogVariantId: input.target === 'variant' ? input.recordId : null,\n    defaultUom: normalizeOptionalString(intent.defaultUom),\n    defaultStrategy: intent.defaultStrategy,\n    trackLot: intent.trackLot ?? false,\n    trackSerial: intent.trackSerial ?? false,\n    trackExpiration: intent.trackExpiration ?? false,\n    reorderPoint: intent.reorderPoint ?? 0,\n    safetyStock: intent.safetyStock ?? 0,\n  }\n\n  if (existingProfile) {\n    await commandBus.execute('wms.inventoryProfiles.update', {\n      input: {\n        id: existingProfile.id,\n        ...profileInput,\n      },\n      ctx,\n    })\n    return\n  }\n\n  await commandBus.execute('wms.inventoryProfiles.create', {\n    input: profileInput,\n    ctx,\n  })\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,29 @@
+const EXPIRING_SOON_DAYS = 30;
+function startOfUtcDay(date) {
+  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()));
+}
+function addUtcDays(date, days) {
+  const next = new Date(date);
+  next.setUTCDate(next.getUTCDate() + days);
+  return next;
+}
+function buildExpiryWindowDateFilter(expiryWindow, now = /* @__PURE__ */ new Date()) {
+  const today = startOfUtcDay(now);
+  if (expiryWindow === "pastDue") {
+    return { expires_at: { $ne: null, $lt: today } };
+  }
+  return {
+    expires_at: {
+      $ne: null,
+      $gte: today,
+      $lte: addUtcDays(today, EXPIRING_SOON_DAYS)
+    }
+  };
+}
+export {
+  EXPIRING_SOON_DAYS,
+  addUtcDays,
+  buildExpiryWindowDateFilter,
+  startOfUtcDay
+};
+//# sourceMappingURL=expiry.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/expiry.ts"],
+  "sourcesContent": ["export const EXPIRING_SOON_DAYS = 30\n\nexport type ExpiryWindow = 'expiringSoon' | 'pastDue'\n\nexport function startOfUtcDay(date: Date): Date {\n  return new Date(Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate()))\n}\n\nexport function addUtcDays(date: Date, days: number): Date {\n  const next = new Date(date)\n  next.setUTCDate(next.getUTCDate() + days)\n  return next\n}\n\nexport function buildExpiryWindowDateFilter(\n  expiryWindow: ExpiryWindow,\n  now: Date = new Date(),\n): Record<string, unknown> {\n  const today = startOfUtcDay(now)\n  if (expiryWindow === 'pastDue') {\n    return { expires_at: { $ne: null, $lt: today } }\n  }\n  return {\n    expires_at: {\n      $ne: null,\n      $gte: today,\n      $lte: addUtcDays(today, EXPIRING_SOON_DAYS),\n    },\n  }\n}\n"],
+  "mappings": "AAAO,MAAM,qBAAqB;AAI3B,SAAS,cAAc,MAAkB;AAC9C,SAAO,IAAI,KAAK,KAAK,IAAI,KAAK,eAAe,GAAG,KAAK,YAAY,GAAG,KAAK,WAAW,CAAC,CAAC;AACxF;AAEO,SAAS,WAAW,MAAY,MAAoB;AACzD,QAAM,OAAO,IAAI,KAAK,IAAI;AAC1B,OAAK,WAAW,KAAK,WAAW,IAAI,IAAI;AACxC,SAAO;AACT;AAEO,SAAS,4BACd,cACA,MAAY,oBAAI,KAAK,GACI;AACzB,QAAM,QAAQ,cAAc,GAAG;AAC/B,MAAI,iBAAiB,WAAW;AAC9B,WAAO,EAAE,YAAY,EAAE,KAAK,MAAM,KAAK,MAAM,EAAE;AAAA,EACjD;AACA,SAAO;AAAA,IACL,YAAY;AAAA,MACV,KAAK;AAAA,MACL,MAAM;AAAA,MACN,MAAM,WAAW,OAAO,kBAAkB;AAAA,IAC5C;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,51 @@
+import { flash } from "@open-mercato/ui/backend/FlashMessages";
+const FORBIDDEN_FEATURE_MESSAGE_KEYS = {
+  "wms.manage_warehouses": "wms.errors.forbidden.manageWarehouses",
+  "wms.manage_zones": "wms.errors.forbidden.manageZones",
+  "wms.manage_locations": "wms.errors.forbidden.manageLocations",
+  "wms.manage_inventory": "wms.errors.forbidden.manageInventory",
+  "wms.manage_reservations": "wms.errors.forbidden.manageReservations",
+  "wms.adjust_inventory": "wms.errors.forbidden.adjustInventory",
+  "wms.receive_inventory": "wms.errors.forbidden.receiveInventory",
+  "wms.cycle_count": "wms.errors.forbidden.cycleCount",
+  "wms.import": "wms.errors.forbidden.import"
+};
+const FORBIDDEN_FEATURE_MESSAGE_FALLBACKS = {
+  "wms.manage_warehouses": "You don't have permission to manage warehouses.",
+  "wms.manage_zones": "You don't have permission to manage warehouse zones.",
+  "wms.manage_locations": "You don't have permission to manage warehouse locations.",
+  "wms.manage_inventory": "You don't have permission to manage inventory profiles.",
+  "wms.manage_reservations": "You don't have permission to manage inventory reservations.",
+  "wms.adjust_inventory": "You don't have permission to adjust or move inventory.",
+  "wms.receive_inventory": "You don't have permission to receive inbound inventory.",
+  "wms.cycle_count": "You don't have permission to run cycle counts.",
+  "wms.import": "You don't have permission to import inventory."
+};
+function resolveForbiddenFeatureMessage(error, t) {
+  if (!error || typeof error !== "object") return null;
+  const status = error.status;
+  if (status !== 403) return null;
+  const requiredFeatures = error.requiredFeatures;
+  if (!Array.isArray(requiredFeatures)) return null;
+  const knownFeature = requiredFeatures.find(
+    (feature) => typeof feature === "string" && feature in FORBIDDEN_FEATURE_MESSAGE_KEYS
+  );
+  if (!knownFeature) return null;
+  const key = FORBIDDEN_FEATURE_MESSAGE_KEYS[knownFeature];
+  const fallback = FORBIDDEN_FEATURE_MESSAGE_FALLBACKS[knownFeature];
+  return t ? t(key, fallback) : fallback;
+}
+function flashMutationError(error, fallbackMessage, t) {
+  const forbiddenMessage = resolveForbiddenFeatureMessage(error, t);
+  if (forbiddenMessage) {
+    flash(forbiddenMessage, "error");
+    return;
+  }
+  const rawMessage = error instanceof Error ? error.message.trim() : "";
+  const isGenericForbidden = rawMessage.length === 0 || /^forbidden$/i.test(rawMessage);
+  flash(isGenericForbidden ? fallbackMessage : rawMessage, "error");
+}
+export {
+  flashMutationError
+};
+//# sourceMappingURL=flashMutationError.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/flashMutationError.ts"],
+  "sourcesContent": ["import { flash } from '@open-mercato/ui/backend/FlashMessages'\nimport type { TranslateFn } from '@open-mercato/shared/lib/i18n/context'\n\n/**\n * Maps a `requireFeatures` ACL feature id to the i18n key that names the\n * specific permission a 403 response is missing (#4102 follow-up \u2014 the\n * generic \"Forbidden\" toast didn't say what was denied).\n */\nconst FORBIDDEN_FEATURE_MESSAGE_KEYS: Record<string, string> = {\n  'wms.manage_warehouses': 'wms.errors.forbidden.manageWarehouses',\n  'wms.manage_zones': 'wms.errors.forbidden.manageZones',\n  'wms.manage_locations': 'wms.errors.forbidden.manageLocations',\n  'wms.manage_inventory': 'wms.errors.forbidden.manageInventory',\n  'wms.manage_reservations': 'wms.errors.forbidden.manageReservations',\n  'wms.adjust_inventory': 'wms.errors.forbidden.adjustInventory',\n  'wms.receive_inventory': 'wms.errors.forbidden.receiveInventory',\n  'wms.cycle_count': 'wms.errors.forbidden.cycleCount',\n  'wms.import': 'wms.errors.forbidden.import',\n}\n\nconst FORBIDDEN_FEATURE_MESSAGE_FALLBACKS: Record<string, string> = {\n  'wms.manage_warehouses': \"You don't have permission to manage warehouses.\",\n  'wms.manage_zones': \"You don't have permission to manage warehouse zones.\",\n  'wms.manage_locations': \"You don't have permission to manage warehouse locations.\",\n  'wms.manage_inventory': \"You don't have permission to manage inventory profiles.\",\n  'wms.manage_reservations': \"You don't have permission to manage inventory reservations.\",\n  'wms.adjust_inventory': \"You don't have permission to adjust or move inventory.\",\n  'wms.receive_inventory': \"You don't have permission to receive inbound inventory.\",\n  'wms.cycle_count': \"You don't have permission to run cycle counts.\",\n  'wms.import': \"You don't have permission to import inventory.\",\n}\n\n/**\n * Reads the 403 response's `requiredFeatures` (attached to the thrown error\n * by `raiseCrudError`) and, when the missing feature is a known WMS\n * permission, resolves a translated message naming it. Returns `null` when\n * the error isn't a recognized 403-with-features shape so callers can fall\n * back to the generic message.\n */\nfunction resolveForbiddenFeatureMessage(error: unknown, t?: TranslateFn): string | null {\n  if (!error || typeof error !== 'object') return null\n  const status = (error as Record<string, unknown>).status\n  if (status !== 403) return null\n  const requiredFeatures = (error as Record<string, unknown>).requiredFeatures\n  if (!Array.isArray(requiredFeatures)) return null\n  const knownFeature = requiredFeatures.find(\n    (feature): feature is string => typeof feature === 'string' && feature in FORBIDDEN_FEATURE_MESSAGE_KEYS,\n  )\n  if (!knownFeature) return null\n  const key = FORBIDDEN_FEATURE_MESSAGE_KEYS[knownFeature]\n  const fallback = FORBIDDEN_FEATURE_MESSAGE_FALLBACKS[knownFeature]\n  return t ? t(key, fallback) : fallback\n}\n\n/**\n * Surfaces a mutation failure as an error flash toast. Prefers a\n * feature-specific 403 message derived from the server's `requiredFeatures`\n * hint (#4102 follow-up), then the thrown error's own message (already\n * server-derived and translated by `raiseCrudError`/`useGuardedMutation`),\n * and falls back to a translated, dialog-specific message otherwise (#4103).\n */\nexport function flashMutationError(error: unknown, fallbackMessage: string, t?: TranslateFn): void {\n  const forbiddenMessage = resolveForbiddenFeatureMessage(error, t)\n  if (forbiddenMessage) {\n    flash(forbiddenMessage, 'error')\n    return\n  }\n  // apiFetch throws ForbiddenError with a bare \"Forbidden\" message when the\n  // ACL body has no mappable feature \u2014 prefer the dialog-specific fallback\n  // over flashing the untranslated server token.\n  const rawMessage = error instanceof Error ? error.message.trim() : ''\n  const isGenericForbidden = rawMessage.length === 0 || /^forbidden$/i.test(rawMessage)\n  flash(isGenericForbidden ? fallbackMessage : rawMessage, 'error')\n}\n"],
+  "mappings": "AAAA,SAAS,aAAa;AAQtB,MAAM,iCAAyD;AAAA,EAC7D,yBAAyB;AAAA,EACzB,oBAAoB;AAAA,EACpB,wBAAwB;AAAA,EACxB,wBAAwB;AAAA,EACxB,2BAA2B;AAAA,EAC3B,wBAAwB;AAAA,EACxB,yBAAyB;AAAA,EACzB,mBAAmB;AAAA,EACnB,cAAc;AAChB;AAEA,MAAM,sCAA8D;AAAA,EAClE,yBAAyB;AAAA,EACzB,oBAAoB;AAAA,EACpB,wBAAwB;AAAA,EACxB,wBAAwB;AAAA,EACxB,2BAA2B;AAAA,EAC3B,wBAAwB;AAAA,EACxB,yBAAyB;AAAA,EACzB,mBAAmB;AAAA,EACnB,cAAc;AAChB;AASA,SAAS,+BAA+B,OAAgB,GAAgC;AACtF,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,SAAU,MAAkC;AAClD,MAAI,WAAW,IAAK,QAAO;AAC3B,QAAM,mBAAoB,MAAkC;AAC5D,MAAI,CAAC,MAAM,QAAQ,gBAAgB,EAAG,QAAO;AAC7C,QAAM,eAAe,iBAAiB;AAAA,IACpC,CAAC,YAA+B,OAAO,YAAY,YAAY,WAAW;AAAA,EAC5E;AACA,MAAI,CAAC,aAAc,QAAO;AAC1B,QAAM,MAAM,+BAA+B,YAAY;AACvD,QAAM,WAAW,oCAAoC,YAAY;AACjE,SAAO,IAAI,EAAE,KAAK,QAAQ,IAAI;AAChC;AASO,SAAS,mBAAmB,OAAgB,iBAAyB,GAAuB;AACjG,QAAM,mBAAmB,+BAA+B,OAAO,CAAC;AAChE,MAAI,kBAAkB;AACpB,UAAM,kBAAkB,OAAO;AAC/B;AAAA,EACF;AAIA,QAAM,aAAa,iBAAiB,QAAQ,MAAM,QAAQ,KAAK,IAAI;AACnE,QAAM,qBAAqB,WAAW,WAAW,KAAK,eAAe,KAAK,UAAU;AACpF,QAAM,qBAAqB,kBAAkB,YAAY,OAAO;AAClE;",
+  "names": []
+}

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

@@ -0,0 +1,188 @@
+import { parseInventoryQuantity } from "./inventoryMutationUi.js";
+const MOVEMENT_TYPE_FALLBACKS = {
+  receipt: "Receive",
+  return_receive: "Receive",
+  adjust: "Adjust",
+  transfer: "Move",
+  pick: "Allocate",
+  pack: "Allocate",
+  cycle_count: "Reconcile",
+  putaway: "Putaway",
+  ship: "Ship"
+};
+const RESERVATION_SOURCE_TYPE_FALLBACKS = {
+  order: "Sales order",
+  transfer: "Transfer",
+  manual: "Manual"
+};
+const REFERENCE_TYPE_FALLBACKS = {
+  po: "Purchase order",
+  so: "Sales order",
+  transfer: "Transfer",
+  manual: "Manual",
+  qc: "Quality control",
+  rma: "RMA"
+};
+const RESERVATION_STATUS_FALLBACKS = {
+  active: "Active",
+  released: "Released",
+  fulfilled: "Fulfilled"
+};
+const ROTATION_STRATEGY_FALLBACKS = {
+  fifo: "FIFO",
+  lifo: "LIFO",
+  fefo: "FEFO"
+};
+const ADJUST_REASON_FALLBACKS = {
+  damaged: "Damaged",
+  shrinkage: "Shrinkage",
+  found: "Found stock",
+  correction: "Correction",
+  other: "Other"
+};
+const MOVE_REASON_FALLBACKS = {
+  transfer: "Transfer",
+  replenishment: "Replenishment",
+  consolidation: "Consolidation",
+  correction: "Correction",
+  other: "Other"
+};
+const RELEASE_REASON_FALLBACKS = {
+  order_cancelled: "Order cancelled",
+  manual_release: "Manual release",
+  correction: "Correction",
+  other: "Other"
+};
+const STABLE_REASON_CODE_PATTERN = /^[a-z][a-z0-9_]*$/;
+function createInventoryQuantityFormatter(locale) {
+  return new Intl.NumberFormat(locale, { maximumFractionDigits: 2 });
+}
+function formatInventoryQuantity(value, formatter) {
+  return formatter.format(parseInventoryQuantity(value));
+}
+function createInventoryDateTimeFormatter(locale, options = {
+  month: "2-digit",
+  day: "2-digit",
+  hour: "2-digit",
+  minute: "2-digit"
+}) {
+  return new Intl.DateTimeFormat(locale, options);
+}
+function formatInventoryDateTime(value, formatter) {
+  if (!value?.trim()) return "\u2014";
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return "\u2014";
+  return formatter.format(date);
+}
+function inventoryMovementTypeLabel(type, t) {
+  const normalized = type.trim();
+  if (!normalized) return "\u2014";
+  return t(
+    `wms.backend.dashboard.activity.types.${normalized}`,
+    MOVEMENT_TYPE_FALLBACKS[normalized] ?? normalized
+  );
+}
+function inventoryReservationSourceTypeLabel(sourceType, t) {
+  const normalized = sourceType.trim();
+  if (!normalized) return "\u2014";
+  return t(
+    `wms.backend.inventory.sourceTypes.${normalized}`,
+    RESERVATION_SOURCE_TYPE_FALLBACKS[normalized] ?? normalized
+  );
+}
+function inventoryReferenceTypeLabel(referenceType, t) {
+  const normalized = referenceType.trim();
+  if (!normalized) return "\u2014";
+  return t(
+    `wms.backend.inventory.referenceTypes.${normalized}`,
+    REFERENCE_TYPE_FALLBACKS[normalized] ?? normalized
+  );
+}
+function inventoryReservationStatusLabel(status, t) {
+  const normalized = status.trim();
+  if (!normalized) return "\u2014";
+  return t(
+    `wms.backend.inventory.reservationStatuses.${normalized}`,
+    RESERVATION_STATUS_FALLBACKS[normalized] ?? normalized
+  );
+}
+function inventoryRotationStrategyLabel(strategy, t) {
+  const normalized = strategy.trim();
+  if (!normalized) return "\u2014";
+  return t(
+    `wms.widgets.catalog.inventoryProfile.strategy.${normalized}`,
+    ROTATION_STRATEGY_FALLBACKS[normalized] ?? normalized
+  );
+}
+function translateStableReasonCode(code, movementType, t) {
+  if (code === "cycle_count") {
+    return t("wms.backend.dashboard.activity.reasons.cycleCount", "Cycle count");
+  }
+  const type = (movementType ?? "").trim();
+  if (type === "transfer" && code in MOVE_REASON_FALLBACKS) {
+    return t(`wms.backend.inventory.move.reasons.${code}`, MOVE_REASON_FALLBACKS[code]);
+  }
+  if ((type === "adjust" || type === "cycle_count") && code in ADJUST_REASON_FALLBACKS) {
+    return t(`wms.backend.inventory.adjust.reasons.${code}`, ADJUST_REASON_FALLBACKS[code]);
+  }
+  if (code in ADJUST_REASON_FALLBACKS) {
+    return t(`wms.backend.inventory.adjust.reasons.${code}`, ADJUST_REASON_FALLBACKS[code]);
+  }
+  if (code in MOVE_REASON_FALLBACKS) {
+    return t(`wms.backend.inventory.move.reasons.${code}`, MOVE_REASON_FALLBACKS[code]);
+  }
+  if (code in RELEASE_REASON_FALLBACKS) {
+    return t(`wms.backend.inventory.release.reasons.${code}`, RELEASE_REASON_FALLBACKS[code]);
+  }
+  return null;
+}
+function inventoryMovementReasonLabel(input, t) {
+  const reasonCode = input.reasonCode?.trim() || null;
+  const reason = input.reason?.trim() || null;
+  const candidateCode = reasonCode || (reason && STABLE_REASON_CODE_PATTERN.test(reason) ? reason : null);
+  if (candidateCode) {
+    const translated = translateStableReasonCode(candidateCode, input.movementType, t);
+    if (translated) return translated;
+  }
+  return reason;
+}
+function formatCatalogProductLabel(row) {
+  const title = (row.product_title ?? "").trim();
+  const sku = (row.product_sku ?? "").trim();
+  if (title && sku) return `${title} (${sku})`;
+  if (title) return title;
+  if (sku) return sku;
+  return row.catalog_product_id?.trim() || "\u2014";
+}
+function formatCatalogVariantLabel(row) {
+  const name = (row.variant_name ?? "").trim();
+  const sku = (row.variant_sku ?? "").trim();
+  if (name && sku) return `${name} (${sku})`;
+  if (name) return name;
+  if (sku) return sku;
+  return row.catalog_variant_id?.trim() || "\u2014";
+}
+function formatReservationSourceLabel(row, t) {
+  const sourceType = row.source_type?.trim();
+  if (!sourceType) return "\u2014";
+  const typeLabel = inventoryReservationSourceTypeLabel(sourceType, t);
+  const sourceLabel = row.source_label?.trim();
+  if (sourceLabel) return `${typeLabel} \xB7 ${sourceLabel}`;
+  return typeLabel;
+}
+export {
+  createInventoryDateTimeFormatter,
+  createInventoryQuantityFormatter,
+  formatCatalogProductLabel,
+  formatCatalogVariantLabel,
+  formatInventoryDateTime,
+  formatInventoryQuantity,
+  formatReservationSourceLabel,
+  inventoryMovementReasonLabel,
+  inventoryMovementTypeLabel,
+  inventoryReferenceTypeLabel,
+  inventoryReservationSourceTypeLabel,
+  inventoryReservationStatusLabel,
+  inventoryRotationStrategyLabel
+};
+//# sourceMappingURL=inventoryDisplayUi.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/inventoryDisplayUi.ts"],
+  "sourcesContent": ["import type { TranslateFn } from '@open-mercato/shared/lib/i18n/context'\nimport { parseInventoryQuantity } from './inventoryMutationUi'\n\nexport type InventoryDisplayTranslator = TranslateFn\n\nconst MOVEMENT_TYPE_FALLBACKS: Record<string, string> = {\n  receipt: 'Receive',\n  return_receive: 'Receive',\n  adjust: 'Adjust',\n  transfer: 'Move',\n  pick: 'Allocate',\n  pack: 'Allocate',\n  cycle_count: 'Reconcile',\n  putaway: 'Putaway',\n  ship: 'Ship',\n}\n\nconst RESERVATION_SOURCE_TYPE_FALLBACKS: Record<string, string> = {\n  order: 'Sales order',\n  transfer: 'Transfer',\n  manual: 'Manual',\n}\n\nconst REFERENCE_TYPE_FALLBACKS: Record<string, string> = {\n  po: 'Purchase order',\n  so: 'Sales order',\n  transfer: 'Transfer',\n  manual: 'Manual',\n  qc: 'Quality control',\n  rma: 'RMA',\n}\n\nconst RESERVATION_STATUS_FALLBACKS: Record<string, string> = {\n  active: 'Active',\n  released: 'Released',\n  fulfilled: 'Fulfilled',\n}\n\nconst ROTATION_STRATEGY_FALLBACKS: Record<string, string> = {\n  fifo: 'FIFO',\n  lifo: 'LIFO',\n  fefo: 'FEFO',\n}\n\nconst ADJUST_REASON_FALLBACKS: Record<string, string> = {\n  damaged: 'Damaged',\n  shrinkage: 'Shrinkage',\n  found: 'Found stock',\n  correction: 'Correction',\n  other: 'Other',\n}\n\nconst MOVE_REASON_FALLBACKS: Record<string, string> = {\n  transfer: 'Transfer',\n  replenishment: 'Replenishment',\n  consolidation: 'Consolidation',\n  correction: 'Correction',\n  other: 'Other',\n}\n\nconst RELEASE_REASON_FALLBACKS: Record<string, string> = {\n  order_cancelled: 'Order cancelled',\n  manual_release: 'Manual release',\n  correction: 'Correction',\n  other: 'Other',\n}\n\nconst STABLE_REASON_CODE_PATTERN = /^[a-z][a-z0-9_]*$/\n\nexport function createInventoryQuantityFormatter(locale: string): Intl.NumberFormat {\n  return new Intl.NumberFormat(locale, { maximumFractionDigits: 2 })\n}\n\nexport function formatInventoryQuantity(\n  value: string | number | null | undefined,\n  formatter: Intl.NumberFormat,\n): string {\n  return formatter.format(parseInventoryQuantity(value))\n}\n\nexport function createInventoryDateTimeFormatter(\n  locale: string,\n  options: Intl.DateTimeFormatOptions = {\n    month: '2-digit',\n    day: '2-digit',\n    hour: '2-digit',\n    minute: '2-digit',\n  },\n): Intl.DateTimeFormat {\n  return new Intl.DateTimeFormat(locale, options)\n}\n\nexport function formatInventoryDateTime(\n  value: string | null | undefined,\n  formatter: Intl.DateTimeFormat,\n): string {\n  if (!value?.trim()) return '\u2014'\n  const date = new Date(value)\n  if (Number.isNaN(date.getTime())) return '\u2014'\n  return formatter.format(date)\n}\n\nexport function inventoryMovementTypeLabel(type: string, t: InventoryDisplayTranslator): string {\n  const normalized = type.trim()\n  if (!normalized) return '\u2014'\n  return t(\n    `wms.backend.dashboard.activity.types.${normalized}`,\n    MOVEMENT_TYPE_FALLBACKS[normalized] ?? normalized,\n  )\n}\n\nexport function inventoryReservationSourceTypeLabel(\n  sourceType: string,\n  t: InventoryDisplayTranslator,\n): string {\n  const normalized = sourceType.trim()\n  if (!normalized) return '\u2014'\n  return t(\n    `wms.backend.inventory.sourceTypes.${normalized}`,\n    RESERVATION_SOURCE_TYPE_FALLBACKS[normalized] ?? normalized,\n  )\n}\n\nexport function inventoryReferenceTypeLabel(\n  referenceType: string,\n  t: InventoryDisplayTranslator,\n): string {\n  const normalized = referenceType.trim()\n  if (!normalized) return '\u2014'\n  return t(\n    `wms.backend.inventory.referenceTypes.${normalized}`,\n    REFERENCE_TYPE_FALLBACKS[normalized] ?? normalized,\n  )\n}\n\nexport function inventoryReservationStatusLabel(status: string, t: InventoryDisplayTranslator): string {\n  const normalized = status.trim()\n  if (!normalized) return '\u2014'\n  return t(\n    `wms.backend.inventory.reservationStatuses.${normalized}`,\n    RESERVATION_STATUS_FALLBACKS[normalized] ?? normalized,\n  )\n}\n\nexport function inventoryRotationStrategyLabel(strategy: string, t: InventoryDisplayTranslator): string {\n  const normalized = strategy.trim()\n  if (!normalized) return '\u2014'\n  return t(\n    `wms.widgets.catalog.inventoryProfile.strategy.${normalized}`,\n    ROTATION_STRATEGY_FALLBACKS[normalized] ?? normalized,\n  )\n}\n\nfunction translateStableReasonCode(\n  code: string,\n  movementType: string | null | undefined,\n  t: InventoryDisplayTranslator,\n): string | null {\n  if (code === 'cycle_count') {\n    return t('wms.backend.dashboard.activity.reasons.cycleCount', 'Cycle count')\n  }\n\n  const type = (movementType ?? '').trim()\n  if (type === 'transfer' && code in MOVE_REASON_FALLBACKS) {\n    return t(`wms.backend.inventory.move.reasons.${code}`, MOVE_REASON_FALLBACKS[code])\n  }\n  if ((type === 'adjust' || type === 'cycle_count') && code in ADJUST_REASON_FALLBACKS) {\n    return t(`wms.backend.inventory.adjust.reasons.${code}`, ADJUST_REASON_FALLBACKS[code])\n  }\n  if (code in ADJUST_REASON_FALLBACKS) {\n    return t(`wms.backend.inventory.adjust.reasons.${code}`, ADJUST_REASON_FALLBACKS[code])\n  }\n  if (code in MOVE_REASON_FALLBACKS) {\n    return t(`wms.backend.inventory.move.reasons.${code}`, MOVE_REASON_FALLBACKS[code])\n  }\n  if (code in RELEASE_REASON_FALLBACKS) {\n    return t(`wms.backend.inventory.release.reasons.${code}`, RELEASE_REASON_FALLBACKS[code])\n  }\n  return null\n}\n\n/**\n * Resolve a movement/activity reason for display. Prefers the stable\n * `reasonCode` (re-translated for the current locale) over a free-text\n * `reason` that may have been baked in a different language at write time.\n */\nexport function inventoryMovementReasonLabel(\n  input: {\n    reasonCode?: string | null\n    reason?: string | null\n    movementType?: string | null\n  },\n  t: InventoryDisplayTranslator,\n): string | null {\n  const reasonCode = input.reasonCode?.trim() || null\n  const reason = input.reason?.trim() || null\n  const candidateCode =\n    reasonCode ||\n    (reason && STABLE_REASON_CODE_PATTERN.test(reason) ? reason : null)\n\n  if (candidateCode) {\n    const translated = translateStableReasonCode(candidateCode, input.movementType, t)\n    if (translated) return translated\n  }\n\n  return reason\n}\n\nexport function formatCatalogProductLabel(row: {\n  product_title?: string | null\n  product_sku?: string | null\n  catalog_product_id?: string | null\n}): string {\n  const title = (row.product_title ?? '').trim()\n  const sku = (row.product_sku ?? '').trim()\n  if (title && sku) return `${title} (${sku})`\n  if (title) return title\n  if (sku) return sku\n  return row.catalog_product_id?.trim() || '\u2014'\n}\n\nexport function formatCatalogVariantLabel(row: {\n  variant_name?: string | null\n  variant_sku?: string | null\n  catalog_variant_id?: string | null\n}): string {\n  const name = (row.variant_name ?? '').trim()\n  const sku = (row.variant_sku ?? '').trim()\n  if (name && sku) return `${name} (${sku})`\n  if (name) return name\n  if (sku) return sku\n  return row.catalog_variant_id?.trim() || '\u2014'\n}\n\nexport function formatReservationSourceLabel(\n  row: {\n    source_type?: string | null\n    source_id?: string | null\n    source_label?: string | null\n  },\n  t: InventoryDisplayTranslator,\n): string {\n  const sourceType = row.source_type?.trim()\n  if (!sourceType) return '\u2014'\n  const typeLabel = inventoryReservationSourceTypeLabel(sourceType, t)\n  const sourceLabel = row.source_label?.trim()\n  if (sourceLabel) return `${typeLabel} \u00B7 ${sourceLabel}`\n  return typeLabel\n}\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,37 @@
+function normalizeSegment(value) {
+  if (typeof value !== "string" || value.trim().length === 0) return "";
+  return value.trim();
+}
+function normalizeQuantity(value) {
+  return String(value);
+}
+function buildMovementIdempotencyKey(input) {
+  return [
+    "movement",
+    normalizeSegment(input.referenceType),
+    normalizeSegment(input.referenceId),
+    normalizeSegment(input.type),
+    normalizeSegment(input.warehouseId),
+    normalizeSegment(input.locationFromId),
+    normalizeSegment(input.locationToId),
+    normalizeSegment(input.catalogVariantId),
+    normalizeSegment(input.lotId),
+    normalizeSegment(input.serialNumber),
+    normalizeQuantity(input.quantity)
+  ].join("|");
+}
+function buildReservationIdempotencyKey(input) {
+  return [
+    "reservation",
+    normalizeSegment(input.sourceType),
+    normalizeSegment(input.sourceId),
+    normalizeSegment(input.catalogVariantId),
+    normalizeSegment(input.warehouseId),
+    normalizeQuantity(input.quantity)
+  ].join("|");
+}
+export {
+  buildMovementIdempotencyKey,
+  buildReservationIdempotencyKey
+};
+//# sourceMappingURL=inventoryIdempotency.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/wms/lib/inventoryIdempotency.ts"],
+  "sourcesContent": ["import type { InventoryMovementType, InventoryReservationSourceType } from '../data/entities'\n\nfunction normalizeSegment(value: string | null | undefined): string {\n  if (typeof value !== 'string' || value.trim().length === 0) return ''\n  return value.trim()\n}\n\nfunction normalizeQuantity(value: number): string {\n  return String(value)\n}\n\nexport function buildMovementIdempotencyKey(input: {\n  referenceType: string\n  referenceId: string\n  type: InventoryMovementType\n  warehouseId: string\n  locationFromId?: string | null\n  locationToId?: string | null\n  catalogVariantId: string\n  lotId?: string | null\n  serialNumber?: string | null\n  quantity: number\n}): string {\n  return [\n    'movement',\n    normalizeSegment(input.referenceType),\n    normalizeSegment(input.referenceId),\n    normalizeSegment(input.type),\n    normalizeSegment(input.warehouseId),\n    normalizeSegment(input.locationFromId),\n    normalizeSegment(input.locationToId),\n    normalizeSegment(input.catalogVariantId),\n    normalizeSegment(input.lotId),\n    normalizeSegment(input.serialNumber),\n    normalizeQuantity(input.quantity),\n  ].join('|')\n}\n\nexport function buildReservationIdempotencyKey(input: {\n  sourceType: InventoryReservationSourceType\n  sourceId: string\n  catalogVariantId: string\n  warehouseId: string\n  quantity: number\n}): string {\n  return [\n    'reservation',\n    normalizeSegment(input.sourceType),\n    normalizeSegment(input.sourceId),\n    normalizeSegment(input.catalogVariantId),\n    normalizeSegment(input.warehouseId),\n    normalizeQuantity(input.quantity),\n  ].join('|')\n}\n"],
+  "mappings": "AAEA,SAAS,iBAAiB,OAA0C;AAClE,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,EAAG,QAAO;AACnE,SAAO,MAAM,KAAK;AACpB;AAEA,SAAS,kBAAkB,OAAuB;AAChD,SAAO,OAAO,KAAK;AACrB;AAEO,SAAS,4BAA4B,OAWjC;AACT,SAAO;AAAA,IACL;AAAA,IACA,iBAAiB,MAAM,aAAa;AAAA,IACpC,iBAAiB,MAAM,WAAW;AAAA,IAClC,iBAAiB,MAAM,IAAI;AAAA,IAC3B,iBAAiB,MAAM,WAAW;AAAA,IAClC,iBAAiB,MAAM,cAAc;AAAA,IACrC,iBAAiB,MAAM,YAAY;AAAA,IACnC,iBAAiB,MAAM,gBAAgB;AAAA,IACvC,iBAAiB,MAAM,KAAK;AAAA,IAC5B,iBAAiB,MAAM,YAAY;AAAA,IACnC,kBAAkB,MAAM,QAAQ;AAAA,EAClC,EAAE,KAAK,GAAG;AACZ;AAEO,SAAS,+BAA+B,OAMpC;AACT,SAAO;AAAA,IACL;AAAA,IACA,iBAAiB,MAAM,UAAU;AAAA,IACjC,iBAAiB,MAAM,QAAQ;AAAA,IAC/B,iBAAiB,MAAM,gBAAgB;AAAA,IACvC,iBAAiB,MAAM,WAAW;AAAA,IAClC,kBAAkB,MAAM,QAAQ;AAAA,EAClC,EAAE,KAAK,GAAG;AACZ;",
+  "names": []
+}