@burdenoff/microfe-movethewheels 2026.929.3 → 2026.930.1

package/dist/movethewheels/types/index.d.ts

@@ -76,6 +76,12 @@ export interface Dimensions {
     height: number;
     unit: 'cm' | 'in' | 'm';
 }
+export interface ProductDimensions {
+    length?: number;
+    width?: number;
+    height?: number;
+    unit?: 'cm' | 'in' | 'm' | string;
+}
 export interface Company {
     id: string;
     name: string;
@@ -132,10 +138,10 @@ export interface Customer {
     phone: string;
     type: 'b2b' | 'b2c';
     company?: string;
-    address: Address;
+    address: Partial<Address>;
     businessLicense?: string;
     taxId?: string;
-    rating: number;
+    rating?: number;
     createdAt: Date;
     updatedAt: Date;
 }
@@ -143,12 +149,12 @@ export interface Product {
     id: string;
     sku: string;
     name: string;
-    description: string;
-    category: string;
+    description?: string;
+    category?: string;
     brand?: string;
-    dimensions: Dimensions;
-    weight: number;
-    value: number;
+    dimensions?: ProductDimensions;
+    weight?: number;
+    value?: number;
     barcode?: string;
     images: string[];
     attributes: Array<{
@@ -271,7 +277,9 @@ export interface Vehicle {
         pallets?: number;
     };
     status: VehicleStatus;
+    /** Deprecated single-driver convenience value; use driverIds for all links. */
     driverId?: string;
+    driverIds: string[];
     currentLocation?: Location;
     lastMaintenance?: Date;
     nextMaintenance?: Date;
@@ -304,11 +312,12 @@ export interface Driver {
     licenseType: string;
     licenseExpiry?: Date;
     vehicleIds: string[];
+    /** Deprecated single-vehicle convenience value; use vehicleIds for all links. */
     assignedVehicle?: string;
     status: DriverStatus;
     currentLocation?: Location;
     /** MtwDriver.rating — a single overall rating; the backend does not track per-category breakdowns. */
-    rating: number;
+    rating?: number;
     /** Free-text HR/performance notes. */
     notes?: string;
     hireDate?: Date;
@@ -326,13 +335,13 @@ export interface Warehouse {
     id: string;
     name: string;
     code: string;
-    address: Address;
+    address: Partial<Address>;
     type: 'distribution' | 'fulfillment' | 'cold_storage' | 'cross_dock' | 'retail';
-    /** Raw backend value (free-text, e.g. "ACTIVE"/"INACTIVE" — defaults to ACTIVE). */
-    status: string;
+    /** Raw backend value (free-text, e.g. "ACTIVE"/"INACTIVE"). */
+    status?: string;
     capacity: {
-        totalSpace: number;
-        usedSpace: number;
+        totalSpace?: number;
+        usedSpace?: number;
     };
     operatingHours: Record<string, {
         open: string;
@@ -342,8 +351,8 @@ export interface Warehouse {
         email?: string;
         phone?: string;
     };
-    /** Real computed value: usedSpace / totalSpace. No other backend metrics exist for a warehouse. */
-    utilization: number;
+    /** Real computed value: usedSpace / totalSpace, when both values are available. */
+    utilization?: number;
     createdAt: Date;
 }
 export interface InventoryMovement {
@@ -379,9 +388,9 @@ export interface RouteStop {
     sequence: number;
     address: Address;
     type: 'pickup' | 'delivery';
-    scheduledTime: Date;
+    scheduledTime?: Date;
     actualTime?: Date;
-    duration: number;
+    duration?: number;
     status: 'pending' | 'completed' | 'skipped' | 'failed';
     notes?: string;
 }
@@ -394,8 +403,8 @@ export interface TrafficCondition {
 export interface Route {
     id: string;
     name: string;
-    driverId: string;
-    vehicleId: string;
+    driverId?: string;
+    vehicleId?: string;
     status: 'planned' | 'in_progress' | 'completed' | 'cancelled';
     stops: RouteStop[];
     distance: number;
@@ -403,7 +412,8 @@ export interface Route {
     /** Estimated fuel cost for the route (svc MtwRoute.fuelCost). */
     fuelCost?: number;
     actualDuration?: number;
-    optimized: boolean;
+    /** Backend currently does not expose whether optimization has run. */
+    optimized?: boolean;
     createdAt: Date;
 }
 export interface TrackingAlert {
@@ -411,7 +421,7 @@ export interface TrackingAlert {
     type: 'delay' | 'deviation' | 'temperature' | 'damage' | 'security';
     severity: 'low' | 'medium' | 'high' | 'critical';
     message: string;
-    timestamp: Date;
+    timestamp?: Date;
     acknowledged: boolean;
     resolvedAt?: Date;
 }
@@ -419,13 +429,13 @@ export interface Tracking {
     id: string;
     entityId: string;
     entityType: 'order' | 'vehicle' | 'driver';
-    currentLocation: Location;
+    currentLocation?: Location;
     locationHistory: Location[];
     status: string;
     estimatedArrival?: Date;
     nextCheckpoint?: string;
     alerts: TrackingAlert[];
-    lastUpdated: Date;
+    lastUpdated?: Date;
 }
 export interface Notification {
     id: string;

package/dist/movethewheels/utils/formatters.d.ts

@@ -3,7 +3,7 @@ import { Address } from '../types';
 /**
  * Format an address object into a readable string.
  */
-export declare function formatAddress(address: Address): string;
+export declare function formatAddress(address: Partial<Address>): string;
 /**
  * Format a number as currency.
  */

package/dist/movethewheels/utils/orderValidation.d.ts

@@ -0,0 +1,11 @@
+import { OrderItem } from '../types';
+
+export type OrderItemField = 'name' | 'sku' | 'quantity' | 'weight' | 'value' | 'length' | 'width' | 'height';
+export type OrderItemFieldErrors = Partial<Record<OrderItemField, string>>;
+/**
+ * Validates one delivery-job cargo line without imposing pricing or order
+ * semantics that belong to the service. A catalog product may supply the name;
+ * every line still carries its SKU because cargo-item records require one.
+ */
+export declare function validateOrderItem(item: OrderItem): OrderItemFieldErrors;
+export declare function validateOrderItems(items: OrderItem[]): Record<string, OrderItemFieldErrors>;