@burdenoff/microfe-movethewheels 2026.704.2 → 2026.710.1

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

@@ -0,0 +1,667 @@
+import { ReactNode } from 'react';
+
+export interface NavItem {
+    id: string;
+    label: string;
+    icon?: ReactNode;
+    path: string;
+    badge?: number;
+    order?: number;
+    group?: string;
+    visible?: boolean;
+    children?: NavItem[];
+}
+export interface FooterItem {
+    id: string;
+    label: string;
+    icon?: string;
+    onClick?: () => void;
+    type?: 'status' | 'action' | 'info';
+    order?: number;
+    badge?: string;
+    section?: 'left' | 'center' | 'right';
+    visible?: boolean;
+}
+export interface User {
+    id: string;
+    email: string;
+    firstName?: string;
+    lastName?: string;
+    avatar?: string;
+    username?: string;
+    name?: string;
+    role?: string;
+}
+export interface MicrofrontendRootProps {
+    basePath: string;
+    navigate: (path: string) => void;
+    currentUser?: User | null;
+    tenantId?: string;
+    workspaceId?: string;
+    apiGatewayUrl?: string;
+    authToken?: string;
+    /**
+     * Workspace-scoped JWT token. The gateway requires both authToken (Authorization)
+     * and workspaceToken (X-Workspace-Authorization) for workspace-scoped operations.
+     */
+    workspaceToken?: string;
+    onAuthError?: () => void;
+    registerNavItems?: (items: NavItem | NavItem[]) => () => void;
+    registerFooterItems?: (items: FooterItem | FooterItem[]) => () => void;
+}
+export interface MoveTheWheelsRootProps extends MicrofrontendRootProps {
+    defaultView?: 'dashboard' | 'orders' | 'fleet';
+    onOrderSelect?: (order: Order) => void;
+}
+export type UserRole = 'business_owner' | 'logistics_manager' | 'operations_coordinator' | 'warehouse_supervisor' | 'warehouse_worker' | 'driver' | 'fleet_operator' | 'dispatcher' | 'customer_b2b' | 'customer_b2c' | 'service_provider' | 'marketplace_vendor';
+export interface Address {
+    street: string;
+    city: string;
+    state: string;
+    postalCode: string;
+    country: string;
+    latitude?: number;
+    longitude?: number;
+}
+export interface Location {
+    latitude: number;
+    longitude: number;
+    address?: string;
+    timestamp?: Date;
+    accuracy?: number;
+}
+export interface Dimensions {
+    length: number;
+    width: number;
+    height: number;
+    unit: 'cm' | 'in' | 'm';
+}
+export interface Company {
+    id: string;
+    name: string;
+    type: string;
+    address: Address;
+    contactInfo: {
+        primaryEmail: string;
+        primaryPhone: string;
+        website?: string;
+    };
+    settings: {
+        timezone: string;
+        currency: string;
+        language: string;
+        notifications: {
+            email: boolean;
+            sms: boolean;
+            push: boolean;
+            orderUpdates: boolean;
+            deliveryAlerts: boolean;
+            systemNotifications: boolean;
+        };
+        integration: Record<string, unknown>;
+    };
+    subscription: {
+        id: string;
+        name: string;
+        type: string;
+        features: string[];
+        limits: {
+            orders: number;
+            users: number;
+            warehouses: number;
+            vehicles: number;
+            storage: number;
+            apiCalls: number;
+        };
+        pricing: {
+            monthly: number;
+            annual: number;
+            currency: string;
+            billingCycle: string;
+        };
+        status: string;
+        startDate: Date;
+    };
+    isActive: boolean;
+    createdAt: Date;
+}
+export interface Customer {
+    id: string;
+    name: string;
+    email: string;
+    phone: string;
+    type: 'b2b' | 'b2c';
+    company?: string;
+    address: Address;
+    businessLicense?: string;
+    taxId?: string;
+    website?: string;
+    preferredContactMethod: 'email' | 'phone' | 'both';
+    marketingOptIn: boolean;
+    notes?: string;
+    isActive: boolean;
+    rating: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface Product {
+    id: string;
+    sku: string;
+    name: string;
+    description: string;
+    category: string;
+    brand?: string;
+    dimensions: Dimensions;
+    weight: number;
+    value: number;
+    barcode?: string;
+    images: string[];
+    attributes: Array<{
+        name: string;
+        value: string;
+        type: string;
+    }>;
+    hazardous: boolean;
+    temperatureControlled: boolean;
+    fragile: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface OrderItem {
+    id: string;
+    productId: string;
+    name: string;
+    description?: string;
+    quantity: number;
+    weight: number;
+    dimensions: Dimensions;
+    value: number;
+    sku: string;
+    barcode?: string;
+}
+export interface OrderTimelineEvent {
+    timestamp: Date;
+    status: string;
+    location?: Address;
+    notes?: string;
+    performedBy: string;
+}
+export interface OrderPricing {
+    subtotal: number;
+    taxes: number;
+    fees: {
+        delivery: number;
+        handling: number;
+        insurance?: number;
+    };
+    total: number;
+    currency: string;
+    paymentMethod: string;
+    paymentStatus: 'pending' | 'paid' | 'failed' | 'refunded';
+}
+export type OrderStatus = 'pending' | 'confirmed' | 'assigned' | 'picked_up' | 'in_transit' | 'out_for_delivery' | 'delivered' | 'cancelled' | 'failed';
+export interface Order {
+    id: string;
+    orderNumber: string;
+    customerId: string;
+    customerInfo: {
+        name: string;
+        email: string;
+        phone: string;
+        company?: string;
+        preferredDeliveryTime?: string;
+        deliveryInstructions?: string;
+    };
+    items: OrderItem[];
+    status: OrderStatus;
+    orderType: 'b2b' | 'b2c';
+    priority: 'low' | 'normal' | 'high' | 'urgent';
+    pickupAddress: Address;
+    deliveryAddress: Address;
+    scheduledPickup?: Date;
+    scheduledDelivery?: Date;
+    actualPickup?: Date;
+    actualDelivery?: Date;
+    driverId?: string;
+    vehicleId?: string;
+    trackingNumber: string;
+    specialInstructions?: string;
+    pricing: OrderPricing;
+    timeline: OrderTimelineEvent[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export type VehicleType = 'van' | 'truck' | 'motorcycle' | 'bicycle' | 'car';
+export type VehicleStatus = 'available' | 'assigned' | 'maintenance' | 'out_of_service';
+export interface VehicleDocument {
+    id: string;
+    type: 'registration' | 'insurance' | 'inspection' | 'permit';
+    documentUrl: string;
+    expiryDate: Date;
+    verified: boolean;
+}
+export interface Vehicle {
+    id: string;
+    vehicleNumber: string;
+    type: VehicleType;
+    make: string;
+    model: string;
+    licensePlate: string;
+    year: number;
+    capacity: {
+        weight: number;
+        volume: number;
+        pallets?: number;
+    };
+    status: VehicleStatus;
+    driverId?: string;
+    currentLocation?: Location;
+    lastMaintenance?: Date;
+    nextMaintenance?: Date;
+    fuelLevel?: number;
+    mileage?: number;
+    documents: VehicleDocument[];
+    createdAt: Date;
+}
+export type DriverStatus = 'available' | 'busy' | 'offline' | 'on_break';
+export interface DriverDocument {
+    id: string;
+    type: 'license' | 'insurance' | 'certification' | 'background_check';
+    documentUrl: string;
+    expiryDate: Date;
+    verified: boolean;
+}
+export interface Driver {
+    id: string;
+    userId: string;
+    fullName: string;
+    email: string;
+    phone: string;
+    employeeId: string;
+    licenseNumber: string;
+    licenseType: string;
+    licenseExpiry: Date;
+    vehicleIds: string[];
+    assignedVehicle?: string;
+    status: DriverStatus;
+    currentLocation?: Location;
+    joinDate: Date;
+    baseSalary: number;
+    completedOrders: number;
+    todayOrders: number;
+    specializations: string[];
+    workingHours: {
+        startTime: string;
+        endTime: string;
+        workingDays: string[];
+        maxHoursPerDay: number;
+        maxHoursPerWeek: number;
+        currentHoursToday: number;
+        currentHoursThisWeek: number;
+    };
+    ratings: {
+        overall: number;
+        punctuality: number;
+        communication: number;
+        carefulHandling: number;
+        professionalism: number;
+        onTimeDelivery: number;
+        totalRatings: number;
+    };
+    documents: DriverDocument[];
+    earnings: {
+        totalEarnings: number;
+        weeklyEarnings: number;
+        monthlyEarnings: number;
+        pendingPayments: number;
+        completedDeliveries: number;
+        bonuses: number;
+    };
+    compliance: {
+        hoursOfService: boolean;
+        documentation: boolean;
+        vehicleInspection: boolean;
+        lastUpdate: Date;
+    };
+    createdAt: Date;
+}
+export interface WarehouseZone {
+    id: string;
+    name: string;
+    type: 'receiving' | 'storage' | 'picking' | 'packing' | 'shipping';
+    location: string;
+    capacity: number;
+    currentOccupancy: number;
+}
+export interface WarehouseEquipment {
+    id: string;
+    type: string;
+    model: string;
+    status: 'operational' | 'maintenance' | 'out_of_service';
+    lastMaintenance: Date;
+    nextMaintenance: Date;
+}
+export interface Warehouse {
+    id: string;
+    name: string;
+    code: string;
+    address: Address;
+    type: 'distribution' | 'fulfillment' | 'cold_storage' | 'cross_dock';
+    capacity: {
+        totalSpace: number;
+        usedSpace: number;
+        totalPallets: number;
+        usedPallets: number;
+        specialAreas: Array<{
+            type: string;
+            capacity: number;
+            currentUsage: number;
+            temperature?: {
+                min: number;
+                max: number;
+                unit: string;
+            };
+        }>;
+    };
+    operatingHours: Record<string, {
+        open: string;
+        close: string;
+    } | null>;
+    contacts: Array<{
+        primaryEmail: string;
+        primaryPhone: string;
+    }>;
+    zones: WarehouseZone[];
+    equipment: WarehouseEquipment[];
+    staff: Array<{
+        userId: string;
+        role: string;
+        shift: string;
+        permissions: string[];
+    }>;
+    metrics: {
+        throughput: number;
+        accuracy: number;
+        productivity: number;
+        utilization: number;
+        ordersFulfilled: number;
+        averageProcessingTime: number;
+        lastUpdated: Date;
+    };
+    isActive: boolean;
+    createdAt: Date;
+}
+export interface InventoryMovement {
+    id: string;
+    type: 'inbound' | 'outbound' | 'transfer' | 'adjustment';
+    quantity: number;
+    reason: string;
+    reference?: string;
+    performedBy: string;
+    timestamp: Date;
+    cost?: number;
+}
+export interface Inventory {
+    id: string;
+    productId: string;
+    warehouseId: string;
+    zoneId: string;
+    quantity: number;
+    reservedQuantity: number;
+    availableQuantity: number;
+    reorderLevel: number;
+    maxLevel: number;
+    lastRestocked: Date;
+    location: {
+        aisle: string;
+        shelf: string;
+        position: string;
+        level: number;
+    };
+    movements: InventoryMovement[];
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface RouteStop {
+    id: string;
+    orderId: string;
+    sequence: number;
+    address: Address;
+    type: 'pickup' | 'delivery';
+    scheduledTime: Date;
+    actualTime?: Date;
+    duration: number;
+    status: 'pending' | 'completed' | 'skipped' | 'failed';
+    notes?: string;
+}
+export interface TrafficCondition {
+    timestamp: Date;
+    condition: 'light' | 'moderate' | 'heavy' | 'severe';
+    delay: number;
+    location: string;
+}
+export interface Route {
+    id: string;
+    name: string;
+    driverId: string;
+    vehicleId: string;
+    status: 'planned' | 'in_progress' | 'completed' | 'cancelled';
+    stops: RouteStop[];
+    distance: number;
+    estimatedDuration: number;
+    /** Estimated fuel cost for the route (svc MtwRoute.fuelCost). */
+    fuelCost?: number;
+    actualDuration?: number;
+    startTime?: Date;
+    endTime?: Date;
+    optimized: boolean;
+    trafficConditions: TrafficCondition[];
+    createdAt: Date;
+}
+export interface TrackingAlert {
+    id: string;
+    type: 'delay' | 'deviation' | 'temperature' | 'damage' | 'security';
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    message: string;
+    timestamp: Date;
+    acknowledged: boolean;
+    resolvedAt?: Date;
+}
+export interface Tracking {
+    id: string;
+    entityId: string;
+    entityType: 'order' | 'vehicle' | 'driver';
+    currentLocation: Location;
+    locationHistory: Location[];
+    status: string;
+    estimatedArrival?: Date;
+    nextCheckpoint?: string;
+    alerts: TrackingAlert[];
+    lastUpdated: Date;
+}
+export interface Notification {
+    id: string;
+    type: 'success' | 'warning' | 'error' | 'info';
+    title: string;
+    message: string;
+    read: boolean;
+    actionUrl?: string;
+    createdAt: Date;
+}
+export interface DashboardWidget {
+    id: string;
+    type: 'metric' | 'chart' | 'table' | 'map' | 'list';
+    title: string;
+    size: 'small' | 'medium' | 'large';
+    position: {
+        x: number;
+        y: number;
+    };
+    config: {
+        dataSource: string;
+        chartType?: string;
+        refreshInterval?: number;
+        metrics?: string[];
+        filters?: Record<string, unknown>;
+    };
+}
+export interface ServiceProvider {
+    id: string;
+    userId: string;
+    companyName: string;
+    businessType: string;
+    description: string;
+    services: string[];
+    coverage: {
+        countries: string[];
+        states: string[];
+        cities: string[];
+        zipCodes: string[];
+        serviceRadius: number;
+        domesticService: boolean;
+        internationalService: boolean;
+    };
+    certifications: Array<{
+        id: string;
+        name: string;
+        issuingBody: string;
+        certificateNumber: string;
+        issueDate: Date;
+        expiryDate: Date;
+        documentUrl: string;
+        verified: boolean;
+    }>;
+    pricing: {
+        model: string;
+        basePrice: number;
+        currency: string;
+        minimumCharge: number;
+        additionalFees: unknown[];
+        discounts: unknown[];
+        negotiable: boolean;
+    };
+    availability: {
+        operatingHours: Record<string, {
+            open: string;
+            close: string;
+        } | null>;
+        responseTime: number;
+        leadTime: number;
+        capacity: number;
+        blackoutDates: string[];
+        emergencyService: boolean;
+    };
+    rating: number;
+    totalReviews: number;
+    verificationStatus: string;
+    documents: unknown[];
+    contactInfo: {
+        primaryEmail: string;
+        primaryPhone: string;
+        website?: string;
+    };
+    isActive: boolean;
+    featured: boolean;
+    createdAt: Date;
+    updatedAt: Date;
+}
+export interface ServiceOffering {
+    id: string;
+    serviceProviderId: string;
+    title: string;
+    description: string;
+    category: string;
+    subCategory: string;
+    features: string[];
+    pricing: {
+        basePrice: number;
+        currency: string;
+        pricePerUnit: number;
+        unit: string;
+        minimumCharge: number;
+    };
+    duration: {
+        estimated: number;
+        minimum: number;
+        maximum: number;
+        unit: string;
+    };
+    requirements: string[];
+    capacity: {
+        maxWeight: number;
+        maxVolume: number;
+        maxDistance: number;
+        simultaneousOrders: number;
+    };
+    images: string[];
+    tags: string[];
+    isActive: boolean;
+    createdAt: Date;
+}
+export interface Analytics {
+    overview: {
+        totalOrders: number;
+        totalRevenue: number;
+        activeVehicles: number;
+        onTimeDeliveryRate: number;
+        customerSatisfaction: number;
+    };
+    trends: {
+        dailyOrders: Array<{
+            date: string;
+            orders: number;
+            deliveries: number;
+        }>;
+        revenue: Array<{
+            month: string;
+            revenue: number;
+        }>;
+    };
+    fleet: {
+        utilization: number;
+        totalVehicles: number;
+        activeVehicles: number;
+        maintenanceVehicles: number;
+        outOfServiceVehicles: number;
+        fuelEfficiency: number;
+    };
+    performance: {
+        onTimePickup: number;
+        onTimeDelivery: number;
+        damagedItems: number;
+        customerComplaints: number;
+        driverRatings: number;
+    };
+}
+export interface OrderFilter {
+    status?: OrderStatus;
+    customerId?: string;
+    driverId?: string;
+    dateFrom?: Date;
+    dateTo?: Date;
+    priority?: string;
+    orderType?: 'b2b' | 'b2c';
+    /**
+     * Client-side quick filter for orders that still need a driver assigned
+     * (driverId is null). The backend OrderFilterInput has no null-driver
+     * predicate, so this is applied to the fetched page after mapping.
+     */
+    unassigned?: boolean;
+}
+export interface FleetFilter {
+    vehicleType?: VehicleType;
+    status?: VehicleStatus;
+    driverId?: string;
+}
+export interface InventoryFilter {
+    warehouseId?: string;
+    productId?: string;
+    lowStock?: boolean;
+}
+export interface CustomerFilter {
+    type?: 'b2b' | 'b2c';
+    isActive?: boolean;
+    search?: string;
+}
+export interface MoveTheWheelsContextValue extends MoveTheWheelsRootProps {
+}

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

@@ -0,0 +1,6 @@
+import { ClassValue } from 'clsx';
+
+/**
+ * Utility for merging Tailwind CSS classes with proper conflict resolution.
+ */
+export declare function cn(...inputs: ClassValue[]): string;

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

@@ -0,0 +1,19 @@
+/**
+ * Small browser download helpers used by report/export surfaces.
+ *
+ * These build an in-memory Blob and trigger a same-document download via a
+ * transient anchor — no network round-trip, so they work against data the MFE
+ * already holds in state.
+ */
+/** Trigger a browser download of `content` as `filename`. */
+export declare function downloadFile(filename: string, content: string, mimeType: string): void;
+/** Download a pretty-printed JSON file. */
+export declare function downloadJson(filename: string, data: unknown): void;
+/**
+ * Flatten a record of scalar values into a two-column (key,value) CSV. Nested
+ * objects/arrays are JSON-encoded into the value cell. Returns null when there
+ * is nothing tabular to emit.
+ */
+export declare function recordToCsv(record: Record<string, unknown> | null | undefined): string | null;
+/** Turn an arbitrary label into a filesystem-safe slug for filenames. */
+export declare function slugifyForFilename(label: string): string;