@de./types 1.0.0

package/src/lsp/processing.ts

@@ -0,0 +1,243 @@
+import { Type, Static } from '@sinclair/typebox'
+import { ActionRecordSchema } from '../time'
+import { AddressSchema } from '../geo'
+import { PSLAddressSchema } from './psl'
+
+// ─── Warehouse processing schemas ─────────────────────────────────────────────
+//
+// Describes the granular process steps executed inside LSP warehouses:
+// receiving, picking, packing, kitting, replenishment, transfer, etc.
+
+export const MovementProcessSchema = Type.Object({
+	from:   PSLAddressSchema,
+	to:     PSLAddressSchema,
+	reason: Type.Union([
+		Type.Literal('MIN_STOCK'),
+		Type.Literal('OPTIMIZATION'),
+		Type.Literal('DAMAGE'),
+		Type.Literal('EXPIRY'),
+		Type.Literal('MANUAL')
+	])
+})
+
+export const CountingProcessSchema = Type.Object({
+	expectedQuantity: Type.Optional(Type.Number({ minimum: 0 })),
+	actualQuantity:   Type.Optional(Type.Number({ minimum: 0 })),
+	variance:         Type.Optional(Type.Number()),
+	processed:        ActionRecordSchema
+})
+
+export const AdjustmentProcessSchema = Type.Object({
+	adjustmentType: Type.Union([
+		Type.Literal('INCREASE'),
+		Type.Literal('DECREASE'),
+		Type.Literal('CORRECTION')
+	]),
+	reason:    Type.String({ maxLength: 500 }),
+	approved:  Type.Optional(ActionRecordSchema),
+	processed: ActionRecordSchema
+})
+
+export const KittingComponentSchema = Type.Object({
+	productId:    Type.String(),
+	sku:          Type.String(),
+	quantity:     Type.Number({ minimum: 1 }),
+	location:     Type.Optional(PSLAddressSchema),
+	serialNumber: Type.Optional(Type.String()),
+	lotNumber:    Type.Optional(Type.String())
+})
+
+export const KittingProcessSchema = Type.Object({
+	components:            Type.Array(KittingComponentSchema),
+	assemblyInstructions:  Type.Optional(Type.String({ maxLength: 2000 })),
+	qualityCheck:          Type.Optional(Type.Boolean()),
+	processed:             ActionRecordSchema
+})
+
+export const ReceivingProcessSchema = Type.Object({
+	dock:          Type.Optional(Type.String()),
+	expectedItems: Type.Number({ minimum: 0 }),
+	receivedItems: Type.Number({ minimum: 0 }),
+	damagedItems:  Type.Number({ minimum: 0 }),
+	shortItems:    Type.Number({ minimum: 0 }),
+	processed:     ActionRecordSchema
+})
+
+export const InspectionProcessSchema = Type.Object({
+	required:  Type.Boolean(),
+	passed:    Type.Optional(Type.Boolean()),
+	issues:    Type.Optional(Type.Array(Type.String())),
+	processed: ActionRecordSchema
+})
+
+export const AllocationItemSchema = Type.Object({
+	productId:   Type.String(),
+	sku:         Type.String(),
+	quantity:    Type.Number({ minimum: 1 }),
+	location:    PSLAddressSchema,
+	reservedFor: Type.Optional(Type.String({ description: 'Order or customer reference' })),
+	expiryDate:  Type.Optional(Type.Number()),
+	lotNumber:   Type.Optional(Type.String())
+})
+
+export const AllocationProcessSchema = Type.Object({
+	items:     Type.Array(AllocationItemSchema),
+	processed: ActionRecordSchema
+})
+
+export const PickItemSchema = Type.Object({
+	productId:         Type.String(),
+	sku:               Type.String(),
+	quantityRequested: Type.Number({ minimum: 1 }),
+	quantityPicked:    Type.Number({ minimum: 0 }),
+	location:          PSLAddressSchema,
+	serialNumbers:     Type.Optional(Type.Array(Type.String())),
+	lotNumber:         Type.Optional(Type.String()),
+	notes:             Type.Optional(Type.String({ maxLength: 200 }))
+})
+
+export const PickingProcessSchema = Type.Object({
+	location:    PSLAddressSchema,
+	startedAt:   Type.Optional(Type.Number()),
+	completedAt: Type.Optional(Type.Number()),
+	pickList:    Type.Array(PickItemSchema),
+	processed:   ActionRecordSchema
+})
+
+export const PackingProcessSchema = Type.Object({
+	station:      Type.Optional(Type.String({ description: 'Packing station identifier' })),
+	startedAt:    Type.Optional(Type.Number()),
+	completedAt:  Type.Optional(Type.Number()),
+	packingSlips: Type.Array(Type.String()),
+	processed:    ActionRecordSchema
+})
+
+export const QualityCheckProcessSchema = Type.Object({
+	required:  Type.Boolean(),
+	passed:    Type.Optional(Type.Boolean()),
+	issues:    Type.Optional(Type.Array(Type.String())),
+	processed: ActionRecordSchema
+})
+
+export const StagingProcessSchema = Type.Object({
+	area:         Type.Optional(Type.String({ description: 'Staging area identifier' })),
+	readyForPickup: Type.Boolean(),
+	processed:    ActionRecordSchema
+})
+
+export const ReplenishmentSchema = Type.Object({
+	from:        PSLAddressSchema,
+	to:          PSLAddressSchema,
+	triggerType: Type.Union([
+		Type.Literal('MIN_STOCK'),
+		Type.Literal('FORECAST'),
+		Type.Literal('MANUAL')
+	]),
+	urgency: Type.Union([
+		Type.Literal('LOW'),
+		Type.Literal('MEDIUM'),
+		Type.Literal('HIGH')
+	]),
+	processed: ActionRecordSchema
+})
+
+export const TransferSchema = Type.Object({
+	from: Type.Union([
+		AddressSchema,
+		Type.String({ description: 'Warehouse ID' })
+	]),
+	to: Type.Union([
+		AddressSchema,
+		Type.String({ description: 'Warehouse ID' })
+	]),
+	reason: Type.Union([
+		Type.Literal('REBALANCING'),
+		Type.Literal('CUSTOMER_REQUEST'),
+		Type.Literal('SEASONAL'),
+		Type.Literal('CONSOLIDATION')
+	]),
+	transportMethod: Type.Optional(Type.String({ description: 'SELF or LSP carrier reference' })),
+	processed:       ActionRecordSchema
+})
+
+// ─── Process metrics & batch ──────────────────────────────────────────────────
+
+export const ProcessDurationSchema = Type.Object({
+	processType: Type.String(),
+	startTime:   Type.Number(),
+	endTime:     Type.Optional(Type.Number()),
+	duration:    Type.Optional(Type.Number({ description: 'Duration in seconds' })),
+	efficiency:  Type.Optional(Type.Number({ minimum: 0, maximum: 100, description: 'Efficiency %' }))
+})
+
+export const ProcessErrorSchema = Type.Object({
+	processType:   Type.String(),
+	errorCode:     Type.String(),
+	errorMessage:  Type.String({ maxLength: 500 }),
+	severity:      Type.Union([
+		Type.Literal('LOW'),
+		Type.Literal('MEDIUM'),
+		Type.Literal('HIGH'),
+		Type.Literal('CRITICAL')
+	]),
+	timestamp:  Type.Number(),
+	resolvedAt: Type.Optional(Type.Number()),
+	resolvedBy: Type.Optional(Type.String())
+})
+
+export const ProcessMetricsSchema = Type.Object({
+	processType:     Type.String(),
+	totalProcessed:  Type.Number({ minimum: 0 }),
+	averageDuration: Type.Number({ minimum: 0, description: 'Average duration in seconds' }),
+	successRate:     Type.Number({ minimum: 0, maximum: 100 }),
+	errorCount:      Type.Number({ minimum: 0 }),
+	throughput:      Type.Number({ minimum: 0, description: 'Items per hour' }),
+	lastProcessed:   Type.Optional(Type.Number())
+})
+
+export const ProcessBatchSchema = Type.Object({
+	batchId:           Type.String(),
+	processType:       Type.String(),
+	items:             Type.Array(Type.String({ description: 'Item or order references' })),
+	assignedTo:        Type.Optional(Type.String()),
+	priority:          Type.Union([
+		Type.Literal('LOW'),
+		Type.Literal('NORMAL'),
+		Type.Literal('HIGH'),
+		Type.Literal('URGENT')
+	]),
+	estimatedDuration: Type.Optional(Type.Number({ description: 'Estimated duration in minutes' })),
+	status:            Type.Union([
+		Type.Literal('PENDING'),
+		Type.Literal('IN_PROGRESS'),
+		Type.Literal('COMPLETED'),
+		Type.Literal('FAILED'),
+		Type.Literal('CANCELLED')
+	]),
+	created:   ActionRecordSchema,
+	started:   Type.Optional(ActionRecordSchema),
+	completed: Type.Optional(ActionRecordSchema)
+})
+
+// ─── TypeScript types ─────────────────────────────────────────────────────────
+
+export type MovementProcess    = Static<typeof MovementProcessSchema>
+export type CountingProcess    = Static<typeof CountingProcessSchema>
+export type AdjustmentProcess  = Static<typeof AdjustmentProcessSchema>
+export type KittingComponent   = Static<typeof KittingComponentSchema>
+export type KittingProcess     = Static<typeof KittingProcessSchema>
+export type ReceivingProcess   = Static<typeof ReceivingProcessSchema>
+export type InspectionProcess  = Static<typeof InspectionProcessSchema>
+export type AllocationItem     = Static<typeof AllocationItemSchema>
+export type AllocationProcess  = Static<typeof AllocationProcessSchema>
+export type PickItem           = Static<typeof PickItemSchema>
+export type PickingProcess     = Static<typeof PickingProcessSchema>
+export type PackingProcess     = Static<typeof PackingProcessSchema>
+export type QualityCheckProcess = Static<typeof QualityCheckProcessSchema>
+export type StagingProcess     = Static<typeof StagingProcessSchema>
+export type Replenishment      = Static<typeof ReplenishmentSchema>
+export type Transfer           = Static<typeof TransferSchema>
+export type ProcessDuration    = Static<typeof ProcessDurationSchema>
+export type ProcessError       = Static<typeof ProcessErrorSchema>
+export type ProcessMetrics     = Static<typeof ProcessMetricsSchema>
+export type ProcessBatch       = Static<typeof ProcessBatchSchema>

package/src/lsp/product.ts

@@ -0,0 +1,104 @@
+import type { Dimensions, Money, Volume, Weight } from '../measure'
+import { ActionRecord, DateTimeZone } from '../time'
+
+export type ProductStatus = 'ACTIVE' | 'INACTIVE' | 'DISCONTINUED' | 'PENDING_APPROVAL'
+export type ProductType = 'PHYSICAL' | 'DIGITAL' | 'SERVICE' | 'BUNDLE' | 'SUBSCRIPTION'
+
+// Universal Product Master - Central catalog entity
+export type Product = {
+  id: string                    // Universal product ID across De. platform
+  name: string
+  description: string
+  shortDescription?: string
+  category: string
+  subcategory?: string
+  brand?: string
+  productType: ProductType
+  
+  // Physical specifications
+  dimensions?: Dimensions
+  weight?: Weight
+  volume?: Volume
+  
+  // Identification codes
+  sku: string                   // Master SKU
+  upc?: string
+  ean?: string
+  isbn?: string
+  
+  // Additional product data
+  specifications: Record<string, any>
+  attributes: Record<string, any>
+  tags: string[]
+  
+  // Pricing (base/suggested - RSP may override)
+  msrp?: Money
+  cost?: Money
+  
+  // Safety & compliance
+  hazmatClass?: string
+  regulatoryInfo?: {
+    requiresLicense: boolean
+    ageRestricted?: number
+    prescriptionRequired?: boolean
+    controlledSubstance?: boolean
+  }
+  
+  // Media assets
+  assets: {
+    images: string[]
+    videos?: string[]
+    documents?: string[]
+    ar3d?: string[]
+  }
+  
+  // Lifecycle
+  status: ProductStatus
+  created: ActionRecord
+  updated?: ActionRecord
+  discontinuedDate?: DateTimeZone
+}
+
+// RSP-specific product overrides
+export type ProductMapping = {
+  id: string
+  productId: string             // Reference to universal Product
+  rspContext: string          // RSP context ID
+  
+  // RSP overrides
+  rspSku: string               // RSP's internal SKU
+  rspProductId?: string        // RSP's internal product ID
+  displayName?: string         // RSP custom display name
+  description?: string         // RSP custom description
+  
+  // RSP pricing
+  pricing: {
+    basePrice: Money
+    salePrice?: Money
+    costPrice?: Money
+    marginPercent?: number
+  }
+  
+  // RSP inventory preferences
+  inventorySettings: {
+    reorderPoint: number
+    reorderQuantity: number
+    maxStock: number
+    safetyStock: number
+    autoReorder: boolean
+  }
+  
+  // Sync configuration
+  syncSettings: {
+    autoSyncInventory: boolean
+    syncPricing: boolean
+    syncDescription: boolean
+    syncImages: boolean
+  }
+  
+  // Status
+  isActive: boolean
+  lastSyncAt?: number
+  created: ActionRecord
+  updated?: ActionRecord
+}