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

package/src/modules/wms/components/backend/useWmsInventoryMutationAccess.ts

@@ -0,0 +1,89 @@
+"use client"
+
+import * as React from 'react'
+import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
+import { useOrganizationScopeDetail } from '@open-mercato/shared/lib/frontend/useOrganizationScope'
+import { hasFeature } from '@open-mercato/shared/security/features'
+import { createLogger } from '@open-mercato/shared/lib/logger'
+
+const logger = createLogger('wms')
+
+type FeatureCheckResponse = {
+  ok?: boolean
+  granted?: string[]
+  userId?: string
+}
+
+export type WmsInventoryMutationAccess = ReturnType<typeof useWmsInventoryMutationAccess>
+
+export function useWmsInventoryMutationAccess() {
+  const { organizationId, tenantId } = useOrganizationScopeDetail()
+  const [granted, setGranted] = React.useState<string[]>([])
+  const [userId, setUserId] = React.useState<string | null>(null)
+  const [loading, setLoading] = React.useState(true)
+
+  React.useEffect(() => {
+    let cancelled = false
+    setLoading(true)
+    async function load() {
+      try {
+        const call = await apiCall<FeatureCheckResponse>('/api/auth/feature-check', {
+          method: 'POST',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({
+            features: [
+              'wms.adjust_inventory',
+              'wms.manage_inventory',
+              'wms.receive_inventory',
+              'wms.cycle_count',
+              'wms.import',
+              'wms.manage_reservations',
+              'wms.manage_locations',
+              'wms.manage_warehouses',
+              'wms.manage_zones',
+            ],
+          }),
+        })
+        if (!cancelled) {
+          setGranted(Array.isArray(call.result?.granted) ? call.result.granted : [])
+          setUserId(typeof call.result?.userId === 'string' ? call.result.userId : null)
+        }
+      } catch (error) {
+        logger.error('feature check failed', { component: 'useWmsInventoryMutationAccess', err: error })
+        if (!cancelled) {
+          setGranted([])
+          setUserId(null)
+        }
+      } finally {
+        if (!cancelled) setLoading(false)
+      }
+    }
+    void load()
+    return () => {
+      cancelled = true
+    }
+  }, [organizationId, tenantId])
+
+  const scopeReady = Boolean(organizationId && tenantId && userId)
+
+  return {
+    loading,
+    organizationId,
+    tenantId,
+    userId,
+    scopeReady,
+    canAdjust: hasFeature(granted, 'wms.adjust_inventory'),
+    canManage: hasFeature(granted, 'wms.manage_inventory'),
+    canReceive: hasFeature(granted, 'wms.receive_inventory'),
+    canCycleCount: hasFeature(granted, 'wms.cycle_count'),
+    canImport: hasFeature(granted, 'wms.import'),
+    canMove: hasFeature(granted, 'wms.adjust_inventory'),
+    canRelease: hasFeature(granted, 'wms.manage_reservations'),
+    canReserve: hasFeature(granted, 'wms.manage_reservations'),
+    canAllocate: hasFeature(granted, 'wms.manage_reservations'),
+    canManageLocations: hasFeature(granted, 'wms.manage_locations'),
+    canManageWarehouses: hasFeature(granted, 'wms.manage_warehouses'),
+    canManageZones: hasFeature(granted, 'wms.manage_zones'),
+    canManageLots: hasFeature(granted, 'wms.manage_inventory'),
+  }
+}

package/src/modules/wms/components/backend/useWmsInventoryScopeFromSearchParams.ts

@@ -0,0 +1,32 @@
+"use client"
+
+import * as React from 'react'
+import { useSearchParams } from 'next/navigation'
+
+export type WmsLowStockFilter = 'belowReorder' | 'belowSafety'
+
+export type WmsInventoryScopeParams = {
+  warehouseId: string
+  catalogVariantId: string
+  lotId: string
+  lowStock: WmsLowStockFilter | null
+}
+
+function parseLowStockFilter(value: string | null): WmsLowStockFilter | null {
+  if (value === 'belowReorder' || value === 'belowSafety') return value
+  return null
+}
+
+export function readWmsInventoryScopeParams(searchParams: URLSearchParams): WmsInventoryScopeParams {
+  return {
+    warehouseId: searchParams.get('warehouseId')?.trim() ?? '',
+    catalogVariantId: searchParams.get('catalogVariantId')?.trim() ?? '',
+    lotId: searchParams.get('lotId')?.trim() ?? '',
+    lowStock: parseLowStockFilter(searchParams.get('lowStock')),
+  }
+}
+
+export function useWmsInventoryScopeFromSearchParams(): WmsInventoryScopeParams {
+  const searchParams = useSearchParams()
+  return React.useMemo(() => readWmsInventoryScopeParams(searchParams), [searchParams])
+}

package/src/modules/wms/components/backend/wmsLookupLoaders.ts

@@ -0,0 +1,78 @@
+import type { CrudFieldOption } from '@open-mercato/ui/backend/CrudForm'
+import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
+
+type PagedResponse<T> = {
+  items: T[]
+  total: number
+  totalPages: number
+}
+
+// Extends CrudFieldOption with an optional description shown below the label in the dropdown.
+// Used by variant comboboxes where label=SKU and description=product name for readability.
+export type CatalogVariantOption = CrudFieldOption & { description: string | null }
+
+export function buildQuery(params: Record<string, string | number | undefined>) {
+  const search = new URLSearchParams()
+  for (const [key, value] of Object.entries(params)) {
+    if (value === undefined || value === '') continue
+    search.set(key, String(value))
+  }
+  return search.toString()
+}
+
+// Merges new label entries into a cache without creating a fresh object
+// reference when nothing actually changed. Callers that feed the result back
+// into React state (e.g. after every ComboboxInput suggestion fetch) rely on
+// this bail-out — otherwise a new object identity on every fetch retriggers
+// downstream effects that depend on that state, looping indefinitely.
+export function mergeLabelCacheEntries(
+  prev: Record<string, string>,
+  entries: Array<{ value: string; label: string }>,
+): Record<string, string> {
+  let next: Record<string, string> | null = null
+  for (const entry of entries) {
+    if (prev[entry.value] !== entry.label) {
+      if (!next) next = { ...prev }
+      next[entry.value] = entry.label
+    }
+  }
+  return next ?? prev
+}
+
+export async function loadWarehouseOptions(query?: string): Promise<CrudFieldOption[]> {
+  const params = buildQuery({ page: 1, pageSize: 50, search: query?.trim() || undefined })
+  const call = await apiCall<PagedResponse<{ id?: string | null; name?: string | null; code?: string | null }>>(
+    `/api/wms/warehouses?${params}`,
+  )
+  if (!call.ok) return []
+  return (call.result?.items ?? [])
+    .map((item) => {
+      const value = typeof item.id === 'string' ? item.id : null
+      if (!value) return null
+      const label = item.name || item.code || value
+      return { value, label }
+    })
+    .filter((option): option is CrudFieldOption => option !== null)
+}
+
+// label=SKU so that fillCombobox helpers searching by SKU can match the dropdown button text
+// and so that input.value after selection equals the SKU typed by the user/test.
+// description=name provides human-readable context beneath the SKU in the dropdown.
+export async function loadCatalogVariantOptions(query?: string): Promise<CatalogVariantOption[]> {
+  const params = buildQuery({ page: 1, pageSize: 25, search: query?.trim() || undefined })
+  const call = await apiCall<PagedResponse<{ id?: string | null; name?: string | null; sku?: string | null }>>(
+    `/api/catalog/variants?${params}`,
+  )
+  if (!call.ok) return []
+  return (call.result?.items ?? [])
+    .map((item) => {
+      const value = typeof item.id === 'string' ? item.id : null
+      if (!value) return null
+      const sku = item.sku?.trim() || null
+      const name = item.name?.trim() || null
+      const label = sku || name || value
+      const description = sku && name && sku !== name ? name : null
+      return { value, label, description }
+    })
+    .filter((option): option is CatalogVariantOption => option !== null)
+}