@open-mercato/core 0.10.1-develop.7709.1.046124599c → 0.10.1-develop.7714.1.9dbb8200d8

package/dist/modules/wms/api/listEnrichers.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/modules/wms/api/listEnrichers.ts"],
-  "sourcesContent": ["// Lightweight afterList enrichers shared across WMS list routes.\n//\n// These run inside `makeCrudRoute({ hooks: { afterList } })` and batch-resolve\n// foreign-key labels (e.g. warehouse_id -> warehouse_name) so backend tables\n// can render the human-readable label without N+1 lookups on the client.\n//\n// We deliberately use the `queryEngine` (entity-id-based) rather than ORM\n// entity classes so this file stays decoupled from `wms/data/entities`\n// internals and from the catalog ORM \u2014 same pattern used by High #5 in WMS\n// data enrichers.\n\nimport type { CrudCtx } from '@open-mercato/shared/lib/crud/factory'\nimport type { QueryEngine } from '@open-mercato/shared/lib/query/types'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { E } from '#generated/entities.ids.generated'\n\nconst logger = createLogger('wms')\n\ntype AnyListPayload = {\n  items?: Array<Record<string, unknown>>\n}\n\ntype LookupRow = Record<string, unknown> & { id?: string | null }\n\nconst LOOKUP_BATCH_SIZE = 500\n\nfunction uniqueIdsFromKeys(\n  items: Array<Record<string, unknown>>,\n  keys: string[],\n): string[] {\n  const set = new Set<string>()\n  for (const item of items) {\n    for (const key of keys) {\n      const value = item?.[key]\n      if (typeof value === 'string' && value.length > 0) set.add(value)\n    }\n  }\n  return Array.from(set)\n}\n\n/**\n * Internal: batch-load `entityId` rows by primary id through the QueryEngine\n * and return them keyed by id. Splits requests into chunks of 500. Errors are\n * logged (with a `source` tag for grep-ability) and degrade to an empty map so\n * the surrounding list response still goes through.\n */\nasync function batchLoadById(\n  ctx: CrudCtx,\n  entityId: string,\n  ids: string[],\n  fields: string[],\n  source: string,\n): Promise<Map<string, LookupRow>> {\n  if (ids.length === 0) return new Map()\n  const tenantId = ctx.auth?.tenantId\n  if (!tenantId) return new Map()\n  const queryEngine = ctx.container.resolve('queryEngine') as QueryEngine\n  const map = new Map<string, LookupRow>()\n  for (let offset = 0; offset < ids.length; offset += LOOKUP_BATCH_SIZE) {\n    const slice = ids.slice(offset, offset + LOOKUP_BATCH_SIZE)\n    try {\n      const result = await queryEngine.query<LookupRow>(entityId, {\n        tenantId,\n        organizationId: ctx.selectedOrganizationId ?? ctx.auth?.orgId ?? undefined,\n        organizationIds: ctx.organizationIds ?? undefined,\n        filters: { id: { $in: slice } },\n        fields,\n        page: { page: 1, pageSize: slice.length },\n      })\n      for (const row of result.items ?? []) {\n        if (row?.id && typeof row.id === 'string') map.set(row.id, row)\n      }\n    } catch (err) {\n      logger.warn('batch lookup failed', { source, entityId, err })\n    }\n  }\n  return map\n}\n\nfunction decorateOnce(item: Record<string, unknown>, key: string, value: unknown): void {\n  if (item[key] === undefined) item[key] = value\n}\n\n// ---------------------------------------------------------------------------\n// Warehouses\n// ---------------------------------------------------------------------------\n\ntype WarehouseRow = LookupRow & { name?: string | null; code?: string | null }\n\nconst WAREHOUSE_FIELDS = ['id', 'name', 'code']\n\n/**\n * Decorate list items with `warehouse_name` and `warehouse_code` when they\n * carry a `warehouse_id` column. Mutates `payload.items` in place.\n */\nexport async function attachWarehouseLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const ids = uniqueIdsFromKeys(items, ['warehouse_id'])\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.wms.warehouse,\n    ids,\n    WAREHOUSE_FIELDS,\n    'warehouse',\n  )) as Map<string, WarehouseRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    const id = item?.warehouse_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    if (!row) continue\n    decorateOnce(item, 'warehouse_name', row.name ?? null)\n    decorateOnce(item, 'warehouse_code', row.code ?? null)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Locations\n// ---------------------------------------------------------------------------\n\ntype LocationLookupRow = LookupRow & { code?: string | null; type?: string | null }\n\nconst LOCATION_FIELDS = ['id', 'code', 'type']\n\n/**\n * Decorate list items with location label/type for any of these foreign-key\n * columns: `location_id`, `location_from_id`, `location_to_id`. The decorated\n * fields follow the same prefix:\n *\n *   location_id        -> location_code, location_type\n *   location_from_id   -> location_from_code, location_from_type\n *   location_to_id     -> location_to_code, location_to_type\n *\n * Mutates `payload.items` in place.\n */\nexport async function attachLocationLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const fkColumns = ['location_id', 'location_from_id', 'location_to_id']\n  const ids = uniqueIdsFromKeys(items, fkColumns)\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.wms.warehouse_location,\n    ids,\n    LOCATION_FIELDS,\n    'location',\n  )) as Map<string, LocationLookupRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    for (const fk of fkColumns) {\n      const id = item?.[fk]\n      if (typeof id !== 'string' || !id) continue\n      const row = map.get(id)\n      if (!row) continue\n      const prefix = fk.replace(/_id$/, '')\n      decorateOnce(item, `${prefix}_code`, row.code ?? null)\n      decorateOnce(item, `${prefix}_type`, row.type ?? null)\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Catalog variants\n// ---------------------------------------------------------------------------\n\ntype VariantLookupRow = LookupRow & {\n  name?: string | null\n  sku?: string | null\n  product_id?: string | null\n}\n\nconst VARIANT_FIELDS = ['id', 'name', 'sku', 'product_id']\n\n/**\n * Decorate list items with `variant_name`, `variant_sku`, and `product_id`\n * when they carry a `catalog_variant_id` column. Mutates `payload.items` in\n * place. Uses `queryEngine.query(E.catalog.catalog_product_variant, ...)`\n * rather than importing the catalog ORM entity directly, to keep the WMS\n * module decoupled from the catalog package internals.\n */\nexport async function attachVariantLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const ids = uniqueIdsFromKeys(items, ['catalog_variant_id'])\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.catalog.catalog_product_variant,\n    ids,\n    VARIANT_FIELDS,\n    'variant',\n  )) as Map<string, VariantLookupRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    const id = item?.catalog_variant_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    if (!row) continue\n    decorateOnce(item, 'variant_name', row.name ?? null)\n    decorateOnce(item, 'variant_sku', row.sku ?? null)\n    decorateOnce(item, 'catalog_product_id', row.product_id ?? null)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Catalog products\n// ---------------------------------------------------------------------------\n\ntype ProductLookupRow = LookupRow & { title?: string | null; sku?: string | null }\n\nconst PRODUCT_FIELDS = ['id', 'title', 'sku']\n\n/**\n * Decorate list items with `product_title` and `product_sku` when they carry a\n * `catalog_product_id` column. Mutates `payload.items` in place.\n */\nexport async function attachProductLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const ids = uniqueIdsFromKeys(items, ['catalog_product_id'])\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.catalog.catalog_product,\n    ids,\n    PRODUCT_FIELDS,\n    'product',\n  )) as Map<string, ProductLookupRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    const id = item?.catalog_product_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    if (!row) continue\n    decorateOnce(item, 'product_title', row.title ?? null)\n    decorateOnce(item, 'product_sku', row.sku ?? null)\n  }\n}\n\n/**\n * Decorate inventory profile rows with catalog product and variant labels.\n * Mutates `payload.items` in place.\n */\nexport async function attachInventoryProfileCatalogLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  await Promise.all([\n    attachProductLabelsToListItems(payload, ctx),\n    attachVariantLabelsToListItems(payload, ctx),\n  ])\n}\n\n// ---------------------------------------------------------------------------\n// Reservation sources\n// ---------------------------------------------------------------------------\n\ntype SalesOrderLookupRow = LookupRow & { order_number?: string | null }\n\nconst SALES_ORDER_FIELDS = ['id', 'order_number']\n\n/**\n * Decorate reservation rows with `source_label` when the source can be resolved\n * to a human-readable reference (currently sales orders). Mutates\n * `payload.items` in place.\n */\nexport async function attachReservationSourceLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n\n  const orderIds = uniqueIdsFromKeys(\n    items.filter((item) => item?.source_type === 'order'),\n    ['source_id'],\n  )\n  if (orderIds.length === 0) return\n\n  const map = (await batchLoadById(\n    ctx,\n    E.sales.sales_order,\n    orderIds,\n    SALES_ORDER_FIELDS,\n    'reservation-source',\n  )) as Map<string, SalesOrderLookupRow>\n  if (map.size === 0) return\n\n  for (const item of items) {\n    if (item?.source_type !== 'order') continue\n    const id = item?.source_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    const orderNumber = row?.order_number?.trim()\n    if (orderNumber) decorateOnce(item, 'source_label', orderNumber)\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["// Lightweight afterList enrichers shared across WMS list routes.\n//\n// These run inside `makeCrudRoute({ hooks: { afterList } })` and batch-resolve\n// foreign-key labels (e.g. warehouse_id -> warehouse_name) so backend tables\n// can render the human-readable label without N+1 lookups on the client.\n//\n// We deliberately use the `queryEngine` (entity-id-based) rather than ORM\n// entity classes so this file stays decoupled from `wms/data/entities`\n// internals and from the catalog ORM \u2014 same pattern used by High #5 in WMS\n// data enrichers.\n\nimport type { CrudCtx } from '@open-mercato/shared/lib/crud/factory'\nimport type { QueryEngine } from '@open-mercato/shared/lib/query/types'\nimport { createLogger } from '@open-mercato/shared/lib/logger'\nimport { E } from '#generated/entities.ids.generated'\n\nconst logger = createLogger('wms')\n\ntype AnyListPayload = {\n  items?: Array<Record<string, unknown>>\n}\n\ntype LookupRow = Record<string, unknown> & { id?: string | null }\n\nconst LOOKUP_BATCH_SIZE = 500\n\nfunction uniqueIdsFromKeys(\n  items: Array<Record<string, unknown>>,\n  keys: string[],\n): string[] {\n  const set = new Set<string>()\n  for (const item of items) {\n    for (const key of keys) {\n      const value = item?.[key]\n      if (typeof value === 'string' && value.length > 0) set.add(value)\n    }\n  }\n  return Array.from(set)\n}\n\n/**\n * Internal: batch-load `entityId` rows by primary id through the QueryEngine\n * and return them keyed by id. Splits requests into chunks of 500. Errors are\n * logged (with a `source` tag for grep-ability) and degrade to an empty map so\n * the surrounding list response still goes through.\n */\nasync function batchLoadById(\n  ctx: CrudCtx,\n  entityId: string,\n  ids: string[],\n  fields: string[],\n  source: string,\n): Promise<Map<string, LookupRow>> {\n  if (ids.length === 0) return new Map()\n  const tenantId = ctx.auth?.tenantId\n  if (!tenantId) return new Map()\n  const queryEngine = ctx.container.resolve('queryEngine') as QueryEngine\n  const map = new Map<string, LookupRow>()\n  for (let offset = 0; offset < ids.length; offset += LOOKUP_BATCH_SIZE) {\n    const slice = ids.slice(offset, offset + LOOKUP_BATCH_SIZE)\n    try {\n      const result = await queryEngine.query<LookupRow>(entityId, {\n        tenantId,\n        organizationId: ctx.selectedOrganizationId ?? ctx.auth?.orgId ?? undefined,\n        organizationIds: ctx.organizationIds ?? undefined,\n        filters: { id: { $in: slice } },\n        fields,\n        page: { page: 1, pageSize: slice.length },\n      })\n      for (const row of result.items ?? []) {\n        if (row?.id && typeof row.id === 'string') map.set(row.id, row)\n      }\n    } catch (err) {\n      logger.warn('batch lookup failed', { source, entityId, err })\n    }\n  }\n  return map\n}\n\nfunction decorateOnce(item: Record<string, unknown>, key: string, value: unknown): void {\n  if (item[key] === undefined) item[key] = value\n}\n\n// ---------------------------------------------------------------------------\n// Warehouses\n// ---------------------------------------------------------------------------\n\ntype WarehouseRow = LookupRow & { name?: string | null; code?: string | null }\n\nconst WAREHOUSE_FIELDS = ['id', 'name', 'code']\n\n/**\n * Decorate list items with `warehouse_name` and `warehouse_code` when they\n * carry a `warehouse_id` column. Mutates `payload.items` in place.\n */\nexport async function attachWarehouseLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const ids = uniqueIdsFromKeys(items, ['warehouse_id'])\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.wms.warehouse,\n    ids,\n    WAREHOUSE_FIELDS,\n    'warehouse',\n  )) as Map<string, WarehouseRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    const id = item?.warehouse_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    if (!row) continue\n    decorateOnce(item, 'warehouse_name', row.name ?? null)\n    decorateOnce(item, 'warehouse_code', row.code ?? null)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Locations\n// ---------------------------------------------------------------------------\n\ntype LocationLookupRow = LookupRow & { code?: string | null; type?: string | null }\n\nconst LOCATION_FIELDS = ['id', 'code', 'type']\n\n/**\n * Decorate list items with location label/type for any of these foreign-key\n * columns: `location_id`, `location_from_id`, `location_to_id`. The decorated\n * fields follow the same prefix:\n *\n *   location_id        -> location_code, location_type\n *   location_from_id   -> location_from_code, location_from_type\n *   location_to_id     -> location_to_code, location_to_type\n *\n * Mutates `payload.items` in place.\n */\nexport async function attachLocationLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const fkColumns = ['location_id', 'location_from_id', 'location_to_id']\n  const ids = uniqueIdsFromKeys(items, fkColumns)\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.wms.warehouse_location,\n    ids,\n    LOCATION_FIELDS,\n    'location',\n  )) as Map<string, LocationLookupRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    for (const fk of fkColumns) {\n      const id = item?.[fk]\n      if (typeof id !== 'string' || !id) continue\n      const row = map.get(id)\n      if (!row) continue\n      const prefix = fk.replace(/_id$/, '')\n      decorateOnce(item, `${prefix}_code`, row.code ?? null)\n      decorateOnce(item, `${prefix}_type`, row.type ?? null)\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Catalog variants\n// ---------------------------------------------------------------------------\n\ntype VariantLookupRow = LookupRow & {\n  name?: string | null\n  sku?: string | null\n  product_id?: string | null\n}\n\nconst VARIANT_FIELDS = ['id', 'name', 'sku', 'product_id']\n\n/**\n * Decorate list items with `variant_name`, `variant_sku`, and `product_id`\n * when they carry a `catalog_variant_id` column. Mutates `payload.items` in\n * place. Uses `queryEngine.query(E.catalog.catalog_product_variant, ...)`\n * rather than importing the catalog ORM entity directly, to keep the WMS\n * module decoupled from the catalog package internals.\n */\nexport async function attachVariantLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const ids = uniqueIdsFromKeys(items, ['catalog_variant_id'])\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.catalog.catalog_product_variant,\n    ids,\n    VARIANT_FIELDS,\n    'variant',\n  )) as Map<string, VariantLookupRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    const id = item?.catalog_variant_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    if (!row) continue\n    decorateOnce(item, 'variant_name', row.name ?? null)\n    decorateOnce(item, 'variant_sku', row.sku ?? null)\n    decorateOnce(item, 'catalog_product_id', row.product_id ?? null)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Catalog products\n// ---------------------------------------------------------------------------\n\ntype ProductLookupRow = LookupRow & { title?: string | null; sku?: string | null }\n\nconst PRODUCT_FIELDS = ['id', 'title', 'sku']\n\n/**\n * Decorate list items with `product_title` and `product_sku` when they carry a\n * `catalog_product_id` column. Mutates `payload.items` in place.\n */\nexport async function attachProductLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const ids = uniqueIdsFromKeys(items, ['catalog_product_id'])\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.catalog.catalog_product,\n    ids,\n    PRODUCT_FIELDS,\n    'product',\n  )) as Map<string, ProductLookupRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    const id = item?.catalog_product_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    if (!row) continue\n    decorateOnce(item, 'product_title', row.title ?? null)\n    decorateOnce(item, 'product_sku', row.sku ?? null)\n  }\n}\n\n/**\n * Decorate inventory profile rows with catalog product and variant labels.\n * Mutates `payload.items` in place.\n */\nexport async function attachInventoryProfileCatalogLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  await Promise.all([\n    attachProductLabelsToListItems(payload, ctx),\n    attachVariantLabelsToListItems(payload, ctx),\n  ])\n}\n\n// ---------------------------------------------------------------------------\n// Customers (ASN vendors)\n// ---------------------------------------------------------------------------\n\ntype CustomerLookupRow = LookupRow & { display_name?: string | null }\n\nconst CUSTOMER_FIELDS = ['id', 'display_name']\n\n/**\n * Decorate list items with `vendor_name` when they carry a `vendor_id` column\n * referencing `customers.customer_entity` by UUID only (no ORM cross-module\n * relations). Mutates `payload.items` in place.\n */\nexport async function attachVendorLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n  const ids = uniqueIdsFromKeys(items, ['vendor_id'])\n  if (ids.length === 0) return\n  const map = (await batchLoadById(\n    ctx,\n    E.customers.customer_entity,\n    ids,\n    CUSTOMER_FIELDS,\n    'vendor',\n  )) as Map<string, CustomerLookupRow>\n  if (map.size === 0) return\n  for (const item of items) {\n    const id = item?.vendor_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    if (!row) continue\n    decorateOnce(item, 'vendor_name', row.display_name ?? null)\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Reservation sources\n// ---------------------------------------------------------------------------\n\ntype SalesOrderLookupRow = LookupRow & { order_number?: string | null }\n\nconst SALES_ORDER_FIELDS = ['id', 'order_number']\n\n/**\n * Decorate reservation rows with `source_label` when the source can be resolved\n * to a human-readable reference (currently sales orders). Mutates\n * `payload.items` in place.\n */\nexport async function attachReservationSourceLabelsToListItems(\n  payload: AnyListPayload,\n  ctx: CrudCtx,\n): Promise<void> {\n  const items = Array.isArray(payload?.items) ? payload.items : []\n  if (items.length === 0) return\n\n  const orderIds = uniqueIdsFromKeys(\n    items.filter((item) => item?.source_type === 'order'),\n    ['source_id'],\n  )\n  if (orderIds.length === 0) return\n\n  const map = (await batchLoadById(\n    ctx,\n    E.sales.sales_order,\n    orderIds,\n    SALES_ORDER_FIELDS,\n    'reservation-source',\n  )) as Map<string, SalesOrderLookupRow>\n  if (map.size === 0) return\n\n  for (const item of items) {\n    if (item?.source_type !== 'order') continue\n    const id = item?.source_id\n    if (typeof id !== 'string' || !id) continue\n    const row = map.get(id)\n    const orderNumber = row?.order_number?.trim()\n    if (orderNumber) decorateOnce(item, 'source_label', orderNumber)\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/wms/api/putaway-tasks/[id]/assign/route.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { readJsonSafe } from "@open-mercato/shared/lib/http/readJsonSafe";
+import { putawayTaskAssignSchema } from "../../../../data/validators.js";
+import { executeWmsCustomPostRoute } from "../../../inventory/helpers.js";
+const metadata = {
+  POST: { requireAuth: true, requireFeatures: ["wms.manage_putaway"] }
+};
+const paramsSchema = z.object({
+  id: z.string().uuid()
+});
+async function POST(request, routeContext) {
+  const parsedParams = paramsSchema.parse(routeContext.params);
+  const body = await readJsonSafe(request, {});
+  const scopedRequest = new Request(request.url, {
+    method: "POST",
+    headers: request.headers,
+    body: JSON.stringify({ ...body, id: parsedParams.id })
+  });
+  return executeWmsCustomPostRoute({
+    request: scopedRequest,
+    routePath: `wms/putaway-tasks/${parsedParams.id}/assign`,
+    inputSchema: putawayTaskAssignSchema,
+    commandId: "wms.putaway-tasks.assign",
+    describeResource: (input) => ({
+      resourceKind: "wms.putawayTask",
+      resourceId: input.id
+    }),
+    mapSuccess: () => ({ ok: true })
+  });
+}
+const successSchema = z.object({ ok: z.literal(true) });
+const errorSchema = z.object({ error: z.string() });
+const openApi = {
+  tag: "WMS",
+  summary: "Assign putaway task",
+  methods: {
+    POST: {
+      summary: "Assign putaway task",
+      description: "Assigns a putaway task to a user.",
+      requestBody: { contentType: "application/json", schema: putawayTaskAssignSchema },
+      responses: [{ status: 200, description: "Putaway task assigned", schema: successSchema }],
+      errors: [
+        { status: 400, description: "Validation failed", schema: errorSchema },
+        { status: 401, description: "Unauthorized", schema: errorSchema },
+        { status: 403, description: "Forbidden", schema: errorSchema },
+        { status: 409, description: "Invalid putaway state", schema: errorSchema }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/wms/api/putaway-tasks/[id]/assign/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/modules/wms/api/putaway-tasks/%5Bid%5D/assign/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'\nimport { putawayTaskAssignSchema } from '../../../../data/validators'\nimport { executeWmsCustomPostRoute } from '../../../inventory/helpers'\n\nexport const metadata = {\n  POST: { requireAuth: true, requireFeatures: ['wms.manage_putaway'] },\n}\n\nconst paramsSchema = z.object({\n  id: z.string().uuid(),\n})\n\nexport async function POST(request: Request, routeContext: { params: { id: string } }) {\n  const parsedParams = paramsSchema.parse(routeContext.params)\n  const body = await readJsonSafe<Record<string, unknown>>(request, {})\n  const scopedRequest = new Request(request.url, {\n    method: 'POST',\n    headers: request.headers,\n    body: JSON.stringify({ ...body, id: parsedParams.id }),\n  })\n  return executeWmsCustomPostRoute({\n    request: scopedRequest,\n    routePath: `wms/putaway-tasks/${parsedParams.id}/assign`,\n    inputSchema: putawayTaskAssignSchema,\n    commandId: 'wms.putaway-tasks.assign',\n    describeResource: (input) => ({\n      resourceKind: 'wms.putawayTask',\n      resourceId: input.id,\n    }),\n    mapSuccess: () => ({ ok: true }),\n  })\n}\n\nconst successSchema = z.object({ ok: z.literal(true) })\nconst errorSchema = z.object({ error: z.string() })\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'WMS',\n  summary: 'Assign putaway task',\n  methods: {\n    POST: {\n      summary: 'Assign putaway task',\n      description: 'Assigns a putaway task to a user.',\n      requestBody: { contentType: 'application/json', schema: putawayTaskAssignSchema },\n      responses: [{ status: 200, description: 'Putaway task assigned', schema: successSchema }],\n      errors: [\n        { status: 400, description: 'Validation failed', schema: errorSchema },\n        { status: 401, description: 'Unauthorized', schema: errorSchema },\n        { status: 403, description: 'Forbidden', schema: errorSchema },\n        { status: 409, description: 'Invalid putaway state', schema: errorSchema },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,oBAAoB;AAC7B,SAAS,+BAA+B;AACxC,SAAS,iCAAiC;AAEnC,MAAM,WAAW;AAAA,EACtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,oBAAoB,EAAE;AACrE;AAEA,MAAM,eAAe,EAAE,OAAO;AAAA,EAC5B,IAAI,EAAE,OAAO,EAAE,KAAK;AACtB,CAAC;AAED,eAAsB,KAAK,SAAkB,cAA0C;AACrF,QAAM,eAAe,aAAa,MAAM,aAAa,MAAM;AAC3D,QAAM,OAAO,MAAM,aAAsC,SAAS,CAAC,CAAC;AACpE,QAAM,gBAAgB,IAAI,QAAQ,QAAQ,KAAK;AAAA,IAC7C,QAAQ;AAAA,IACR,SAAS,QAAQ;AAAA,IACjB,MAAM,KAAK,UAAU,EAAE,GAAG,MAAM,IAAI,aAAa,GAAG,CAAC;AAAA,EACvD,CAAC;AACD,SAAO,0BAA0B;AAAA,IAC/B,SAAS;AAAA,IACT,WAAW,qBAAqB,aAAa,EAAE;AAAA,IAC/C,aAAa;AAAA,IACb,WAAW;AAAA,IACX,kBAAkB,CAAC,WAAW;AAAA,MAC5B,cAAc;AAAA,MACd,YAAY,MAAM;AAAA,IACpB;AAAA,IACA,YAAY,OAAO,EAAE,IAAI,KAAK;AAAA,EAChC,CAAC;AACH;AAEA,MAAM,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;AACtD,MAAM,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAE3C,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,SAAS;AAAA,MACT,aAAa;AAAA,MACb,aAAa,EAAE,aAAa,oBAAoB,QAAQ,wBAAwB;AAAA,MAChF,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,yBAAyB,QAAQ,cAAc,CAAC;AAAA,MACxF,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,qBAAqB,QAAQ,YAAY;AAAA,QACrE,EAAE,QAAQ,KAAK,aAAa,gBAAgB,QAAQ,YAAY;AAAA,QAChE,EAAE,QAAQ,KAAK,aAAa,aAAa,QAAQ,YAAY;AAAA,QAC7D,EAAE,QAAQ,KAAK,aAAa,yBAAyB,QAAQ,YAAY;AAAA,MAC3E;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/wms/api/putaway-tasks/[id]/cancel/route.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { readJsonSafe } from "@open-mercato/shared/lib/http/readJsonSafe";
+import { putawayTaskCancelSchema } from "../../../../data/validators.js";
+import { executeWmsCustomPostRoute } from "../../../inventory/helpers.js";
+const metadata = {
+  POST: { requireAuth: true, requireFeatures: ["wms.manage_putaway"] }
+};
+const paramsSchema = z.object({
+  id: z.string().uuid()
+});
+async function POST(request, routeContext) {
+  const parsedParams = paramsSchema.parse(routeContext.params);
+  const body = await readJsonSafe(request, {});
+  const scopedRequest = new Request(request.url, {
+    method: "POST",
+    headers: request.headers,
+    body: JSON.stringify({ ...body, id: parsedParams.id })
+  });
+  return executeWmsCustomPostRoute({
+    request: scopedRequest,
+    routePath: `wms/putaway-tasks/${parsedParams.id}/cancel`,
+    inputSchema: putawayTaskCancelSchema,
+    commandId: "wms.putaway-tasks.cancel",
+    describeResource: (input) => ({
+      resourceKind: "wms.putawayTask",
+      resourceId: input.id
+    }),
+    mapSuccess: () => ({ ok: true })
+  });
+}
+const successSchema = z.object({ ok: z.literal(true) });
+const errorSchema = z.object({ error: z.string() });
+const openApi = {
+  tag: "WMS",
+  summary: "Cancel putaway task",
+  methods: {
+    POST: {
+      summary: "Cancel putaway task",
+      description: "Cancels an open or in-progress putaway task without moving stock.",
+      requestBody: { contentType: "application/json", schema: putawayTaskCancelSchema },
+      responses: [{ status: 200, description: "Putaway task cancelled", schema: successSchema }],
+      errors: [
+        { status: 400, description: "Validation failed", schema: errorSchema },
+        { status: 401, description: "Unauthorized", schema: errorSchema },
+        { status: 403, description: "Forbidden", schema: errorSchema },
+        { status: 409, description: "Invalid putaway state", schema: errorSchema }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/wms/api/putaway-tasks/[id]/cancel/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/modules/wms/api/putaway-tasks/%5Bid%5D/cancel/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'\nimport { putawayTaskCancelSchema } from '../../../../data/validators'\nimport { executeWmsCustomPostRoute } from '../../../inventory/helpers'\n\nexport const metadata = {\n  POST: { requireAuth: true, requireFeatures: ['wms.manage_putaway'] },\n}\n\nconst paramsSchema = z.object({\n  id: z.string().uuid(),\n})\n\nexport async function POST(request: Request, routeContext: { params: { id: string } }) {\n  const parsedParams = paramsSchema.parse(routeContext.params)\n  const body = await readJsonSafe<Record<string, unknown>>(request, {})\n  const scopedRequest = new Request(request.url, {\n    method: 'POST',\n    headers: request.headers,\n    body: JSON.stringify({ ...body, id: parsedParams.id }),\n  })\n  return executeWmsCustomPostRoute({\n    request: scopedRequest,\n    routePath: `wms/putaway-tasks/${parsedParams.id}/cancel`,\n    inputSchema: putawayTaskCancelSchema,\n    commandId: 'wms.putaway-tasks.cancel',\n    describeResource: (input) => ({\n      resourceKind: 'wms.putawayTask',\n      resourceId: input.id,\n    }),\n    mapSuccess: () => ({ ok: true }),\n  })\n}\n\nconst successSchema = z.object({ ok: z.literal(true) })\nconst errorSchema = z.object({ error: z.string() })\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'WMS',\n  summary: 'Cancel putaway task',\n  methods: {\n    POST: {\n      summary: 'Cancel putaway task',\n      description: 'Cancels an open or in-progress putaway task without moving stock.',\n      requestBody: { contentType: 'application/json', schema: putawayTaskCancelSchema },\n      responses: [{ status: 200, description: 'Putaway task cancelled', schema: successSchema }],\n      errors: [\n        { status: 400, description: 'Validation failed', schema: errorSchema },\n        { status: 401, description: 'Unauthorized', schema: errorSchema },\n        { status: 403, description: 'Forbidden', schema: errorSchema },\n        { status: 409, description: 'Invalid putaway state', schema: errorSchema },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,oBAAoB;AAC7B,SAAS,+BAA+B;AACxC,SAAS,iCAAiC;AAEnC,MAAM,WAAW;AAAA,EACtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,oBAAoB,EAAE;AACrE;AAEA,MAAM,eAAe,EAAE,OAAO;AAAA,EAC5B,IAAI,EAAE,OAAO,EAAE,KAAK;AACtB,CAAC;AAED,eAAsB,KAAK,SAAkB,cAA0C;AACrF,QAAM,eAAe,aAAa,MAAM,aAAa,MAAM;AAC3D,QAAM,OAAO,MAAM,aAAsC,SAAS,CAAC,CAAC;AACpE,QAAM,gBAAgB,IAAI,QAAQ,QAAQ,KAAK;AAAA,IAC7C,QAAQ;AAAA,IACR,SAAS,QAAQ;AAAA,IACjB,MAAM,KAAK,UAAU,EAAE,GAAG,MAAM,IAAI,aAAa,GAAG,CAAC;AAAA,EACvD,CAAC;AACD,SAAO,0BAA0B;AAAA,IAC/B,SAAS;AAAA,IACT,WAAW,qBAAqB,aAAa,EAAE;AAAA,IAC/C,aAAa;AAAA,IACb,WAAW;AAAA,IACX,kBAAkB,CAAC,WAAW;AAAA,MAC5B,cAAc;AAAA,MACd,YAAY,MAAM;AAAA,IACpB;AAAA,IACA,YAAY,OAAO,EAAE,IAAI,KAAK;AAAA,EAChC,CAAC;AACH;AAEA,MAAM,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;AACtD,MAAM,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAE3C,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,SAAS;AAAA,MACT,aAAa;AAAA,MACb,aAAa,EAAE,aAAa,oBAAoB,QAAQ,wBAAwB;AAAA,MAChF,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,0BAA0B,QAAQ,cAAc,CAAC;AAAA,MACzF,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,qBAAqB,QAAQ,YAAY;AAAA,QACrE,EAAE,QAAQ,KAAK,aAAa,gBAAgB,QAAQ,YAAY;AAAA,QAChE,EAAE,QAAQ,KAAK,aAAa,aAAa,QAAQ,YAAY;AAAA,QAC7D,EAAE,QAAQ,KAAK,aAAa,yBAAyB,QAAQ,YAAY;AAAA,MAC3E;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/wms/api/putaway-tasks/[id]/complete/route.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import { readJsonSafe } from "@open-mercato/shared/lib/http/readJsonSafe";
+import { putawayTaskCompleteSchema } from "../../../../data/validators.js";
+import { executeWmsCustomPostRoute } from "../../../inventory/helpers.js";
+const metadata = {
+  // Floor ACL: stock-moving operators (`wms.adjust_inventory`) and managers both hold this.
+  // Command also allows `wms.manage_putaway` for any task, or adjust + assignee match.
+  POST: { requireAuth: true, requireFeatures: ["wms.adjust_inventory"] }
+};
+const paramsSchema = z.object({
+  id: z.string().uuid()
+});
+async function POST(request, routeContext) {
+  const parsedParams = paramsSchema.parse(routeContext.params);
+  const body = await readJsonSafe(request, {});
+  const scopedRequest = new Request(request.url, {
+    method: "POST",
+    headers: request.headers,
+    body: JSON.stringify({ ...body, id: parsedParams.id })
+  });
+  return executeWmsCustomPostRoute({
+    request: scopedRequest,
+    routePath: `wms/putaway-tasks/${parsedParams.id}/complete`,
+    inputSchema: putawayTaskCompleteSchema,
+    commandId: "wms.putaway-tasks.complete",
+    describeResource: (input) => ({
+      resourceKind: "wms.putawayTask",
+      resourceId: input.id
+    }),
+    mapSuccess: (result) => ({
+      ok: true,
+      movementId: result.movementId
+    })
+  });
+}
+const successSchema = z.object({
+  ok: z.literal(true),
+  movementId: z.string().uuid()
+});
+const errorSchema = z.object({ error: z.string() });
+const openApi = {
+  tag: "WMS",
+  summary: "Complete putaway task",
+  methods: {
+    POST: {
+      summary: "Complete putaway task",
+      description: "Confirms putaway quantity and target location, then moves stock staging\u2192storage via an InventoryMovement of type putaway. Requires `wms.adjust_inventory`. Callers with `wms.manage_putaway` may complete any task; operators may complete only when the task is assigned to them.",
+      requestBody: { contentType: "application/json", schema: putawayTaskCompleteSchema },
+      responses: [{ status: 200, description: "Putaway completed", schema: successSchema }],
+      errors: [
+        { status: 400, description: "Validation failed", schema: errorSchema },
+        { status: 401, description: "Unauthorized", schema: errorSchema },
+        { status: 403, description: "Forbidden", schema: errorSchema },
+        { status: 409, description: "Invalid putaway state or insufficient stock", schema: errorSchema },
+        { status: 422, description: "Invalid or inactive location", schema: errorSchema }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/wms/api/putaway-tasks/[id]/complete/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/modules/wms/api/putaway-tasks/%5Bid%5D/complete/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'\nimport { putawayTaskCompleteSchema } from '../../../../data/validators'\nimport { executeWmsCustomPostRoute } from '../../../inventory/helpers'\n\nexport const metadata = {\n  // Floor ACL: stock-moving operators (`wms.adjust_inventory`) and managers both hold this.\n  // Command also allows `wms.manage_putaway` for any task, or adjust + assignee match.\n  POST: { requireAuth: true, requireFeatures: ['wms.adjust_inventory'] },\n}\n\nconst paramsSchema = z.object({\n  id: z.string().uuid(),\n})\n\nexport async function POST(request: Request, routeContext: { params: { id: string } }) {\n  const parsedParams = paramsSchema.parse(routeContext.params)\n  const body = await readJsonSafe<Record<string, unknown>>(request, {})\n  const scopedRequest = new Request(request.url, {\n    method: 'POST',\n    headers: request.headers,\n    body: JSON.stringify({ ...body, id: parsedParams.id }),\n  })\n  return executeWmsCustomPostRoute({\n    request: scopedRequest,\n    routePath: `wms/putaway-tasks/${parsedParams.id}/complete`,\n    inputSchema: putawayTaskCompleteSchema,\n    commandId: 'wms.putaway-tasks.complete',\n    describeResource: (input) => ({\n      resourceKind: 'wms.putawayTask',\n      resourceId: input.id,\n    }),\n    mapSuccess: (result: { movementId: string }) => ({\n      ok: true,\n      movementId: result.movementId,\n    }),\n  })\n}\n\nconst successSchema = z.object({\n  ok: z.literal(true),\n  movementId: z.string().uuid(),\n})\nconst errorSchema = z.object({ error: z.string() })\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'WMS',\n  summary: 'Complete putaway task',\n  methods: {\n    POST: {\n      summary: 'Complete putaway task',\n      description:\n        'Confirms putaway quantity and target location, then moves stock staging\u2192storage via an InventoryMovement of type putaway. Requires `wms.adjust_inventory`. Callers with `wms.manage_putaway` may complete any task; operators may complete only when the task is assigned to them.',\n      requestBody: { contentType: 'application/json', schema: putawayTaskCompleteSchema },\n      responses: [{ status: 200, description: 'Putaway completed', schema: successSchema }],\n      errors: [\n        { status: 400, description: 'Validation failed', schema: errorSchema },\n        { status: 401, description: 'Unauthorized', schema: errorSchema },\n        { status: 403, description: 'Forbidden', schema: errorSchema },\n        { status: 409, description: 'Invalid putaway state or insufficient stock', schema: errorSchema },\n        { status: 422, description: 'Invalid or inactive location', schema: errorSchema },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,oBAAoB;AAC7B,SAAS,iCAAiC;AAC1C,SAAS,iCAAiC;AAEnC,MAAM,WAAW;AAAA;AAAA;AAAA,EAGtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,sBAAsB,EAAE;AACvE;AAEA,MAAM,eAAe,EAAE,OAAO;AAAA,EAC5B,IAAI,EAAE,OAAO,EAAE,KAAK;AACtB,CAAC;AAED,eAAsB,KAAK,SAAkB,cAA0C;AACrF,QAAM,eAAe,aAAa,MAAM,aAAa,MAAM;AAC3D,QAAM,OAAO,MAAM,aAAsC,SAAS,CAAC,CAAC;AACpE,QAAM,gBAAgB,IAAI,QAAQ,QAAQ,KAAK;AAAA,IAC7C,QAAQ;AAAA,IACR,SAAS,QAAQ;AAAA,IACjB,MAAM,KAAK,UAAU,EAAE,GAAG,MAAM,IAAI,aAAa,GAAG,CAAC;AAAA,EACvD,CAAC;AACD,SAAO,0BAA0B;AAAA,IAC/B,SAAS;AAAA,IACT,WAAW,qBAAqB,aAAa,EAAE;AAAA,IAC/C,aAAa;AAAA,IACb,WAAW;AAAA,IACX,kBAAkB,CAAC,WAAW;AAAA,MAC5B,cAAc;AAAA,MACd,YAAY,MAAM;AAAA,IACpB;AAAA,IACA,YAAY,CAAC,YAAoC;AAAA,MAC/C,IAAI;AAAA,MACJ,YAAY,OAAO;AAAA,IACrB;AAAA,EACF,CAAC;AACH;AAEA,MAAM,gBAAgB,EAAE,OAAO;AAAA,EAC7B,IAAI,EAAE,QAAQ,IAAI;AAAA,EAClB,YAAY,EAAE,OAAO,EAAE,KAAK;AAC9B,CAAC;AACD,MAAM,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAE3C,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,SAAS;AAAA,MACT,aACE;AAAA,MACF,aAAa,EAAE,aAAa,oBAAoB,QAAQ,0BAA0B;AAAA,MAClF,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,qBAAqB,QAAQ,cAAc,CAAC;AAAA,MACpF,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,qBAAqB,QAAQ,YAAY;AAAA,QACrE,EAAE,QAAQ,KAAK,aAAa,gBAAgB,QAAQ,YAAY;AAAA,QAChE,EAAE,QAAQ,KAAK,aAAa,aAAa,QAAQ,YAAY;AAAA,QAC7D,EAAE,QAAQ,KAAK,aAAa,+CAA+C,QAAQ,YAAY;AAAA,QAC/F,EAAE,QAAQ,KAAK,aAAa,gCAAgC,QAAQ,YAAY;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/wms/api/putaway-tasks/[id]/start/route.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { readJsonSafe } from "@open-mercato/shared/lib/http/readJsonSafe";
+import { putawayTaskStartSchema } from "../../../../data/validators.js";
+import { executeWmsCustomPostRoute } from "../../../inventory/helpers.js";
+const metadata = {
+  POST: { requireAuth: true, requireFeatures: ["wms.manage_putaway"] }
+};
+const paramsSchema = z.object({
+  id: z.string().uuid()
+});
+async function POST(request, routeContext) {
+  const parsedParams = paramsSchema.parse(routeContext.params);
+  const body = await readJsonSafe(request, {});
+  const scopedRequest = new Request(request.url, {
+    method: "POST",
+    headers: request.headers,
+    body: JSON.stringify({ ...body, id: parsedParams.id })
+  });
+  return executeWmsCustomPostRoute({
+    request: scopedRequest,
+    routePath: `wms/putaway-tasks/${parsedParams.id}/start`,
+    inputSchema: putawayTaskStartSchema,
+    commandId: "wms.putaway-tasks.start",
+    describeResource: (input) => ({
+      resourceKind: "wms.putawayTask",
+      resourceId: input.id
+    }),
+    mapSuccess: () => ({ ok: true })
+  });
+}
+const successSchema = z.object({ ok: z.literal(true) });
+const errorSchema = z.object({ error: z.string() });
+const openApi = {
+  tag: "WMS",
+  summary: "Start putaway task",
+  methods: {
+    POST: {
+      summary: "Start putaway task",
+      description: "Marks a putaway task as in progress.",
+      requestBody: { contentType: "application/json", schema: putawayTaskStartSchema },
+      responses: [{ status: 200, description: "Putaway task started", schema: successSchema }],
+      errors: [
+        { status: 400, description: "Validation failed", schema: errorSchema },
+        { status: 401, description: "Unauthorized", schema: errorSchema },
+        { status: 403, description: "Forbidden", schema: errorSchema },
+        { status: 409, description: "Invalid putaway state", schema: errorSchema }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/wms/api/putaway-tasks/[id]/start/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/modules/wms/api/putaway-tasks/%5Bid%5D/start/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport { readJsonSafe } from '@open-mercato/shared/lib/http/readJsonSafe'\nimport { putawayTaskStartSchema } from '../../../../data/validators'\nimport { executeWmsCustomPostRoute } from '../../../inventory/helpers'\n\nexport const metadata = {\n  POST: { requireAuth: true, requireFeatures: ['wms.manage_putaway'] },\n}\n\nconst paramsSchema = z.object({\n  id: z.string().uuid(),\n})\n\nexport async function POST(request: Request, routeContext: { params: { id: string } }) {\n  const parsedParams = paramsSchema.parse(routeContext.params)\n  const body = await readJsonSafe<Record<string, unknown>>(request, {})\n  const scopedRequest = new Request(request.url, {\n    method: 'POST',\n    headers: request.headers,\n    body: JSON.stringify({ ...body, id: parsedParams.id }),\n  })\n  return executeWmsCustomPostRoute({\n    request: scopedRequest,\n    routePath: `wms/putaway-tasks/${parsedParams.id}/start`,\n    inputSchema: putawayTaskStartSchema,\n    commandId: 'wms.putaway-tasks.start',\n    describeResource: (input) => ({\n      resourceKind: 'wms.putawayTask',\n      resourceId: input.id,\n    }),\n    mapSuccess: () => ({ ok: true }),\n  })\n}\n\nconst successSchema = z.object({ ok: z.literal(true) })\nconst errorSchema = z.object({ error: z.string() })\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'WMS',\n  summary: 'Start putaway task',\n  methods: {\n    POST: {\n      summary: 'Start putaway task',\n      description: 'Marks a putaway task as in progress.',\n      requestBody: { contentType: 'application/json', schema: putawayTaskStartSchema },\n      responses: [{ status: 200, description: 'Putaway task started', schema: successSchema }],\n      errors: [\n        { status: 400, description: 'Validation failed', schema: errorSchema },\n        { status: 401, description: 'Unauthorized', schema: errorSchema },\n        { status: 403, description: 'Forbidden', schema: errorSchema },\n        { status: 409, description: 'Invalid putaway state', schema: errorSchema },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,oBAAoB;AAC7B,SAAS,8BAA8B;AACvC,SAAS,iCAAiC;AAEnC,MAAM,WAAW;AAAA,EACtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,oBAAoB,EAAE;AACrE;AAEA,MAAM,eAAe,EAAE,OAAO;AAAA,EAC5B,IAAI,EAAE,OAAO,EAAE,KAAK;AACtB,CAAC;AAED,eAAsB,KAAK,SAAkB,cAA0C;AACrF,QAAM,eAAe,aAAa,MAAM,aAAa,MAAM;AAC3D,QAAM,OAAO,MAAM,aAAsC,SAAS,CAAC,CAAC;AACpE,QAAM,gBAAgB,IAAI,QAAQ,QAAQ,KAAK;AAAA,IAC7C,QAAQ;AAAA,IACR,SAAS,QAAQ;AAAA,IACjB,MAAM,KAAK,UAAU,EAAE,GAAG,MAAM,IAAI,aAAa,GAAG,CAAC;AAAA,EACvD,CAAC;AACD,SAAO,0BAA0B;AAAA,IAC/B,SAAS;AAAA,IACT,WAAW,qBAAqB,aAAa,EAAE;AAAA,IAC/C,aAAa;AAAA,IACb,WAAW;AAAA,IACX,kBAAkB,CAAC,WAAW;AAAA,MAC5B,cAAc;AAAA,MACd,YAAY,MAAM;AAAA,IACpB;AAAA,IACA,YAAY,OAAO,EAAE,IAAI,KAAK;AAAA,EAChC,CAAC;AACH;AAEA,MAAM,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;AACtD,MAAM,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAE3C,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,SAAS;AAAA,MACT,aAAa;AAAA,MACb,aAAa,EAAE,aAAa,oBAAoB,QAAQ,uBAAuB;AAAA,MAC/E,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,wBAAwB,QAAQ,cAAc,CAAC;AAAA,MACvF,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,qBAAqB,QAAQ,YAAY;AAAA,QACrE,EAAE,QAAQ,KAAK,aAAa,gBAAgB,QAAQ,YAAY;AAAA,QAChE,EAAE,QAAQ,KAAK,aAAa,aAAa,QAAQ,YAAY;AAAA,QAC7D,EAAE,QAAQ,KAAK,aAAa,yBAAyB,QAAQ,YAAY;AAAA,MAC3E;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/wms/api/putaway-tasks/create-from-balance/route.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { putawayTaskCreateFromBalanceSchema } from "../../../data/validators.js";
+import { executeWmsCustomPostRoute } from "../../inventory/helpers.js";
+const metadata = {
+  POST: { requireAuth: true, requireFeatures: ["wms.manage_putaway"] }
+};
+async function POST(request) {
+  return executeWmsCustomPostRoute({
+    request,
+    routePath: "wms/putaway-tasks/create-from-balance",
+    inputSchema: putawayTaskCreateFromBalanceSchema,
+    commandId: "wms.putaway-tasks.create-from-balance",
+    describeResource: (input) => ({
+      resourceKind: "wms.putawayTask",
+      resourceId: `${input.warehouseId}:${input.sourceLocationId}:${input.catalogVariantId}`
+    }),
+    mapSuccess: (result) => ({
+      ok: true,
+      taskId: result.taskId
+    })
+  });
+}
+const successSchema = z.object({
+  ok: z.literal(true),
+  taskId: z.string().uuid()
+});
+const errorSchema = z.object({ error: z.string() });
+const openApi = {
+  tag: "WMS",
+  summary: "Create putaway task from balance",
+  methods: {
+    POST: {
+      summary: "Create putaway task from balance",
+      description: "Manually creates an open putaway task against existing staged stock.",
+      requestBody: { contentType: "application/json", schema: putawayTaskCreateFromBalanceSchema },
+      responses: [{ status: 200, description: "Putaway task created", schema: successSchema }],
+      errors: [
+        { status: 400, description: "Validation failed", schema: errorSchema },
+        { status: 401, description: "Unauthorized", schema: errorSchema },
+        { status: 403, description: "Forbidden", schema: errorSchema },
+        { status: 422, description: "Invalid location", schema: errorSchema }
+      ]
+    }
+  }
+};
+export {
+  POST,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map

package/dist/modules/wms/api/putaway-tasks/create-from-balance/route.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/modules/wms/api/putaway-tasks/create-from-balance/route.ts"],
+  "sourcesContent": ["import { z } from 'zod'\nimport type { OpenApiRouteDoc } from '@open-mercato/shared/lib/openapi'\nimport { putawayTaskCreateFromBalanceSchema } from '../../../data/validators'\nimport { executeWmsCustomPostRoute } from '../../inventory/helpers'\n\nexport const metadata = {\n  POST: { requireAuth: true, requireFeatures: ['wms.manage_putaway'] },\n}\n\nexport async function POST(request: Request) {\n  return executeWmsCustomPostRoute({\n    request,\n    routePath: 'wms/putaway-tasks/create-from-balance',\n    inputSchema: putawayTaskCreateFromBalanceSchema,\n    commandId: 'wms.putaway-tasks.create-from-balance',\n    describeResource: (input) => ({\n      resourceKind: 'wms.putawayTask',\n      resourceId: `${input.warehouseId}:${input.sourceLocationId}:${input.catalogVariantId}`,\n    }),\n    mapSuccess: (result: { taskId: string }) => ({\n      ok: true,\n      taskId: result.taskId,\n    }),\n  })\n}\n\nconst successSchema = z.object({\n  ok: z.literal(true),\n  taskId: z.string().uuid(),\n})\nconst errorSchema = z.object({ error: z.string() })\n\nexport const openApi: OpenApiRouteDoc = {\n  tag: 'WMS',\n  summary: 'Create putaway task from balance',\n  methods: {\n    POST: {\n      summary: 'Create putaway task from balance',\n      description: 'Manually creates an open putaway task against existing staged stock.',\n      requestBody: { contentType: 'application/json', schema: putawayTaskCreateFromBalanceSchema },\n      responses: [{ status: 200, description: 'Putaway task created', schema: successSchema }],\n      errors: [\n        { status: 400, description: 'Validation failed', schema: errorSchema },\n        { status: 401, description: 'Unauthorized', schema: errorSchema },\n        { status: 403, description: 'Forbidden', schema: errorSchema },\n        { status: 422, description: 'Invalid location', schema: errorSchema },\n      ],\n    },\n  },\n}\n"],
+  "mappings": "AAAA,SAAS,SAAS;AAElB,SAAS,0CAA0C;AACnD,SAAS,iCAAiC;AAEnC,MAAM,WAAW;AAAA,EACtB,MAAM,EAAE,aAAa,MAAM,iBAAiB,CAAC,oBAAoB,EAAE;AACrE;AAEA,eAAsB,KAAK,SAAkB;AAC3C,SAAO,0BAA0B;AAAA,IAC/B;AAAA,IACA,WAAW;AAAA,IACX,aAAa;AAAA,IACb,WAAW;AAAA,IACX,kBAAkB,CAAC,WAAW;AAAA,MAC5B,cAAc;AAAA,MACd,YAAY,GAAG,MAAM,WAAW,IAAI,MAAM,gBAAgB,IAAI,MAAM,gBAAgB;AAAA,IACtF;AAAA,IACA,YAAY,CAAC,YAAgC;AAAA,MAC3C,IAAI;AAAA,MACJ,QAAQ,OAAO;AAAA,IACjB;AAAA,EACF,CAAC;AACH;AAEA,MAAM,gBAAgB,EAAE,OAAO;AAAA,EAC7B,IAAI,EAAE,QAAQ,IAAI;AAAA,EAClB,QAAQ,EAAE,OAAO,EAAE,KAAK;AAC1B,CAAC;AACD,MAAM,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAE3C,MAAM,UAA2B;AAAA,EACtC,KAAK;AAAA,EACL,SAAS;AAAA,EACT,SAAS;AAAA,IACP,MAAM;AAAA,MACJ,SAAS;AAAA,MACT,aAAa;AAAA,MACb,aAAa,EAAE,aAAa,oBAAoB,QAAQ,mCAAmC;AAAA,MAC3F,WAAW,CAAC,EAAE,QAAQ,KAAK,aAAa,wBAAwB,QAAQ,cAAc,CAAC;AAAA,MACvF,QAAQ;AAAA,QACN,EAAE,QAAQ,KAAK,aAAa,qBAAqB,QAAQ,YAAY;AAAA,QACrE,EAAE,QAAQ,KAAK,aAAa,gBAAgB,QAAQ,YAAY;AAAA,QAChE,EAAE,QAAQ,KAAK,aAAa,aAAa,QAAQ,YAAY;AAAA,QAC7D,EAAE,QAAQ,KAAK,aAAa,oBAAoB,QAAQ,YAAY;AAAA,MACtE;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/modules/wms/api/putaway-tasks/route.js

@@ -0,0 +1,192 @@
+import { z } from "zod";
+import { makeCrudRoute } from "@open-mercato/shared/lib/crud/factory";
+import { resolveTranslations } from "@open-mercato/shared/lib/i18n/server";
+import { parseScopedCommandInput, resolveCrudRecordId } from "@open-mercato/shared/lib/api/scoped";
+import { E } from "../../../../generated/entities.ids.generated.js";
+import { PutawayTask } from "../../data/entities.js";
+import { putawayTaskCreateSchema, putawayTaskUpdateSchema } from "../../data/validators.js";
+import {
+  assertPutawayLifecycleFieldsForbidden,
+  buildPutawayTaskStatusFilter
+} from "../../lib/putaway.js";
+import { createPagedListResponseSchema, createWmsCrudOpenApi, defaultOkResponseSchema } from "../openapi.js";
+const F = {
+  id: "id",
+  organization_id: "organization_id",
+  tenant_id: "tenant_id",
+  warehouse_id: "warehouse_id",
+  source_location_id: "source_location_id",
+  target_location_id: "target_location_id",
+  catalog_variant_id: "catalog_variant_id",
+  lot_id: "lot_id",
+  serial_number: "serial_number",
+  quantity: "quantity",
+  status: "status",
+  assigned_to: "assigned_to",
+  priority: "priority",
+  created_at: "created_at",
+  updated_at: "updated_at"
+};
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ["wms.view"] },
+  POST: { requireAuth: true, requireFeatures: ["wms.manage_putaway"] },
+  PUT: { requireAuth: true, requireFeatures: ["wms.manage_putaway"] },
+  DELETE: { requireAuth: true, requireFeatures: ["wms.manage_putaway"] }
+};
+const metadata = routeMetadata;
+const rawBodySchema = z.object({}).passthrough();
+const listSchema = z.object({
+  page: z.coerce.number().min(1).default(1),
+  pageSize: z.coerce.number().min(1).max(100).default(25),
+  ids: z.string().optional(),
+  warehouseId: z.string().uuid().optional(),
+  // Single status or comma-separated (e.g. open,in_progress for the active queue).
+  status: z.string().optional(),
+  assignedTo: z.string().uuid().optional(),
+  catalogVariantId: z.string().uuid().optional(),
+  sortField: z.string().optional(),
+  sortDir: z.enum(["asc", "desc"]).optional()
+}).passthrough();
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: PutawayTask,
+    idField: "id",
+    orgField: "organizationId",
+    tenantField: "tenantId",
+    softDeleteField: "deletedAt"
+  },
+  indexer: { entityType: E.wms.putaway_task },
+  list: {
+    schema: listSchema,
+    disableListCache: true,
+    entityId: E.wms.putaway_task,
+    fields: [
+      F.id,
+      F.organization_id,
+      F.tenant_id,
+      F.warehouse_id,
+      F.source_location_id,
+      F.target_location_id,
+      F.catalog_variant_id,
+      F.lot_id,
+      F.serial_number,
+      F.quantity,
+      F.status,
+      F.assigned_to,
+      F.priority,
+      F.created_at,
+      F.updated_at
+    ],
+    sortFieldMap: {
+      status: F.status,
+      priority: F.priority,
+      createdAt: F.created_at,
+      updatedAt: F.updated_at,
+      quantity: F.quantity
+    },
+    buildFilters: async (query) => {
+      const filters = {};
+      if (typeof query.ids === "string" && query.ids.trim().length > 0) {
+        filters[F.id] = {
+          $in: query.ids.split(",").map((value) => value.trim()).filter((value) => value.length > 0)
+        };
+      }
+      if (typeof query.warehouseId === "string" && query.warehouseId.length > 0) {
+        filters[F.warehouse_id] = { $eq: query.warehouseId };
+      }
+      if (typeof query.status === "string" && query.status.length > 0) {
+        const statusFilter = buildPutawayTaskStatusFilter(query.status);
+        if (statusFilter) filters[F.status] = statusFilter;
+      }
+      if (typeof query.assignedTo === "string" && query.assignedTo.length > 0) {
+        filters[F.assigned_to] = { $eq: query.assignedTo };
+      }
+      if (typeof query.catalogVariantId === "string" && query.catalogVariantId.length > 0) {
+        filters[F.catalog_variant_id] = { $eq: query.catalogVariantId };
+      }
+      return filters;
+    }
+  },
+  actions: {
+    create: {
+      commandId: "wms.putaway-tasks.create",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        return parseScopedCommandInput(putawayTaskCreateSchema, raw ?? {}, ctx, translate);
+      },
+      response: ({ result }) => ({ id: result?.taskId ?? null }),
+      status: 201
+    },
+    update: {
+      commandId: "wms.putaway-tasks.update",
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations();
+        assertPutawayLifecycleFieldsForbidden(raw);
+        return parseScopedCommandInput(putawayTaskUpdateSchema, raw ?? {}, ctx, translate);
+      },
+      response: () => ({ ok: true })
+    },
+    delete: {
+      commandId: "wms.putaway-tasks.delete",
+      schema: rawBodySchema,
+      mapInput: async ({ parsed, ctx }) => {
+        const { translate } = await resolveTranslations();
+        return { id: resolveCrudRecordId(parsed, ctx, translate) };
+      },
+      response: () => ({ ok: true })
+    }
+  }
+});
+const GET = crud.GET;
+const POST = crud.POST;
+const PUT = crud.PUT;
+const DELETE = crud.DELETE;
+const putawayTaskListItemSchema = z.object({
+  id: z.string().uuid().nullable().optional(),
+  organization_id: z.string().uuid().nullable().optional(),
+  tenant_id: z.string().uuid().nullable().optional(),
+  warehouse_id: z.string().uuid().nullable().optional(),
+  source_location_id: z.string().uuid().nullable().optional(),
+  target_location_id: z.string().uuid().nullable().optional(),
+  catalog_variant_id: z.string().uuid().nullable().optional(),
+  lot_id: z.string().uuid().nullable().optional(),
+  serial_number: z.string().nullable().optional(),
+  quantity: z.union([z.string(), z.number()]).nullable().optional(),
+  status: z.string().nullable().optional(),
+  assigned_to: z.string().uuid().nullable().optional(),
+  priority: z.union([z.string(), z.number()]).nullable().optional(),
+  created_at: z.string().nullable().optional(),
+  updated_at: z.string().nullable().optional()
+});
+const openApi = createWmsCrudOpenApi({
+  resourceName: "PutawayTask",
+  pluralName: "Putaway tasks",
+  querySchema: listSchema,
+  listResponseSchema: createPagedListResponseSchema(putawayTaskListItemSchema),
+  create: {
+    schema: putawayTaskCreateSchema,
+    description: "Creates an open putaway task after verifying available staging balance (on-hand minus reserved/allocated minus open/in-progress putaway commitments). Target location may be null until completion. Assignee changes use POST .../assign."
+  },
+  update: {
+    schema: putawayTaskUpdateSchema,
+    responseSchema: defaultOkResponseSchema,
+    description: "Updates putaway task fields (locations, quantity, priority, metadata). Status and assignedTo are lifecycle-only \u2014 use POST .../{assign,start,complete,cancel}."
+  },
+  del: {
+    schema: z.object({ id: z.string().uuid() }),
+    responseSchema: defaultOkResponseSchema,
+    description: "Soft-deletes a putaway task by id."
+  }
+});
+export {
+  DELETE,
+  GET,
+  POST,
+  PUT,
+  metadata,
+  openApi
+};
+//# sourceMappingURL=route.js.map