@de./types 1.0.0

package/src/lsp/carrier/index.ts

@@ -0,0 +1,175 @@
+import { Type, Static } from '@sinclair/typebox'
+import { MoneySchema } from '../../measure'
+import {
+	BaseServiceDefinitionSchema,
+	BaseServiceDefinitionUpdateSchema
+} from '../../service'
+import { EntityStatusSchema } from '../../entity'
+import {
+	APIErrorSchema,
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory
+} from '../../api'
+
+// Carrier Type Schema - Industry standard carrier classifications
+export const CarrierTypeSchema = Type.Union([
+  Type.Literal('LTL'),              // Less Than Truckload
+  Type.Literal('FTL'),              // Full Truckload
+  Type.Literal('PARCEL'),           // Small package delivery
+  Type.Literal('EXPRESS'),          // Express/expedited delivery
+  Type.Literal('FREIGHT'),          // Heavy freight
+  Type.Literal('LAST_MILE'),        // Final mile delivery
+  Type.Literal('LINEHAUL'),         // Long distance transport
+  Type.Literal('TRANSIT'),          // Scheduled bus/public transit
+  Type.Literal('SHUTTLE'),          // Shuttle services
+  Type.Literal('CHARTER'),          // Charter bus services
+  Type.Literal('RIDESHARE'),        // Ride-sharing services (Uber, Lyft-style)
+  Type.Literal('LOCAL'),            // Local delivery
+  Type.Literal('INTERMODAL'),       // Multi-modal transport
+  Type.Literal('SPECIALIZED'),      // Specialized cargo (hazmat, oversized, etc.)
+  Type.Literal('COURIER')           // Courier/messenger service
+])
+
+export const CarrierSchema = Type.Composite([
+  BaseServiceDefinitionSchema,
+  Type.Object({
+    type: CarrierTypeSchema,
+    coverage: Type.Array(Type.String()), // Coverage rules Codes
+    pricing: Type.Array(Type.String()), // Pricing rules Codes
+
+    fleetSize: Type.Number({ minimum: 0 }),
+    
+    // Performance
+    performance: Type.Optional(Type.Object({
+      throughput: Type.Object({
+        current: Type.Number({ minimum: 0 }),
+        peak: Type.Number({ minimum: 0 }),
+        average: Type.Number({ minimum: 0 }),
+        target: Type.Number({ minimum: 0 })
+      }),
+
+      timing: Type.Object({
+        averageProcessingTime: Type.Number({ minimum: 0, description: 'minutes' }),
+        averageDwellTime: Type.Number({ minimum: 0, description: 'minutes' }),
+        onTimePerformance: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+      }),
+      
+      quality: Type.Object({
+        accuracy: Type.Number({ minimum: 0, maximum: 100 }),
+        damageRate: Type.Number({ minimum: 0, maximum: 100 }),
+        lossRate: Type.Number({ minimum: 0, maximum: 100 }),
+        customerSatisfaction: Type.Optional(Type.Number({ minimum: 0, maximum: 100 }))
+      }),
+      
+      utilization: Type.Object({
+        capacity: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+        equipment: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+        labor: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+      }),
+      
+      costs: Type.Optional(Type.Object({
+        operatingCostPerPackage: MoneySchema,
+        totalOperatingCost: MoneySchema,
+        efficiencyRating: Type.Number({ minimum: 0, maximum: 100 })
+      }))
+    }))
+  })
+])
+
+export const CarrierUpdateSchema = Type.Composite([
+  BaseServiceDefinitionUpdateSchema,
+  Type.Object({
+    type: Type.Optional(CarrierTypeSchema)
+  })
+])
+
+export type CarrierType   = Static<typeof CarrierTypeSchema>
+export type Carrier       = Static<typeof CarrierSchema>
+export type CarrierUpdate = Static<typeof CarrierUpdateSchema>
+
+// ─── Request Validation Schemas ───────────────────────────────────────────────
+
+export const CarrierCreateBodySchema = Type.Omit(CarrierSchema, [
+	'id', 'context',
+	'status', 'alerts',
+	'fleetSize',
+	'created', 'updated'
+])
+
+export const CarrierStatusUpdateBodySchema = Type.Object({
+	status: EntityStatusSchema,
+	reason: Type.Optional(Type.String({ maxLength: 500 }))
+})
+
+export const CarrierListQuerySchema = Type.Object({
+	status: Type.Optional(EntityStatusSchema),
+	type:   Type.Optional(CarrierTypeSchema),
+	limit:  Type.Optional(Type.Number({ minimum: 1, maximum: 200, default: 20 })),
+	offset: Type.Optional(Type.Number({ minimum: 0, default: 0 }))
+})
+
+export const LSPCarrierCreateRVS = {
+	headers:  APIHeadersSchema,
+	body:     CarrierCreateBodySchema,
+	response: APIResponseDataSchemaFactory({ carrierId: Type.String() })
+}
+
+export const LSPCarrierRetrieveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	response: APIResponseDataSchemaFactory({ carrier: CarrierSchema })
+}
+
+export const LSPCarrierListRVS = {
+	headers:     APIHeadersSchema,
+	querystring: CarrierListQuerySchema,
+	response:    APIResponseDataSchemaFactory({
+		carriers: Type.Array(CarrierSchema),
+		total:    Type.Number(),
+		limit:    Type.Number(),
+		offset:   Type.Number()
+	})
+}
+
+export const LSPCarrierUpdateRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     CarrierUpdateSchema,
+	response: APIResponseDataSchemaFactory({ carrier: CarrierSchema })
+}
+
+export const LSPCarrierUpdateStatusRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     CarrierStatusUpdateBodySchema,
+	response: APIResponseDataSchemaFactory({ carrier: CarrierSchema })
+}
+
+export const LSPCarrierRemoveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	response: APIResponseBaseSchema
+}
+
+export type LSPCarrierCreateValidation       = { headers: Static<typeof LSPCarrierCreateRVS.headers>, body: Static<typeof LSPCarrierCreateRVS.body>, response: Static<typeof LSPCarrierCreateRVS.response> }
+export type LSPCarrierRetrieveValidation     = { headers: Static<typeof LSPCarrierRetrieveRVS.headers>, params: Static<typeof LSPCarrierRetrieveRVS.params>, response: Static<typeof LSPCarrierRetrieveRVS.response> }
+export type LSPCarrierListValidation         = { headers: Static<typeof LSPCarrierListRVS.headers>, querystring: Static<typeof LSPCarrierListRVS.querystring>, response: Static<typeof LSPCarrierListRVS.response> }
+export type LSPCarrierUpdateValidation       = { headers: Static<typeof LSPCarrierUpdateRVS.headers>, params: Static<typeof LSPCarrierUpdateRVS.params>, body: Static<typeof LSPCarrierUpdateRVS.body>, response: Static<typeof LSPCarrierUpdateRVS.response> }
+export type LSPCarrierUpdateStatusValidation = { headers: Static<typeof LSPCarrierUpdateStatusRVS.headers>, params: Static<typeof LSPCarrierUpdateStatusRVS.params>, body: Static<typeof LSPCarrierUpdateStatusRVS.body>, response: Static<typeof LSPCarrierUpdateStatusRVS.response> }
+export type LSPCarrierRemoveValidation       = { headers: Static<typeof LSPCarrierRemoveRVS.headers>, params: Static<typeof LSPCarrierRemoveRVS.params>, response: Static<typeof LSPCarrierRemoveRVS.response> }
+
+// Re-export all carrier capability schemas and types
+export * from './capabilities'
+
+// Re-export all carrier capacity schemas and types
+export * from './capacities'
+
+// Re-export all carrier performance schemas and types
+export * from './performance'
+
+// Re-export all carrier analytics schemas and types
+export * from './analytics'
+
+// Re-export all carrier utilities schemas and types
+export * from './utilities'

package/src/lsp/carrier/performance.ts

@@ -0,0 +1,145 @@
+import { Type, Static } from '@sinclair/typebox'
+import { CoverageTransitModeSchema } from '../coverage'
+import { CarrierCapacitySchema } from './capacities'
+import { CarrierCapabilitySchema } from './capabilities'
+import { SPPerformanceSummarySchema } from '../../context'
+import { DurationSchema } from '../../time'
+import { WeightSchema, ServiceLevelSchema, MoneySchema, PerTimeSchema, DistanceSchema } from '../../measure'
+import { EntityStatusSchema } from '../../entity'
+
+// Current performance metrics
+export const CarrierCurrentPerformanceSchema = Type.Object({
+  operationalMetrics: Type.Object({
+    onTimePerformance: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    deliveryAccuracy: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    firstAttemptDelivery: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    damageRate: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    lossRate: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    customerSatisfaction: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    complaintRate: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    serviceRecoveryRate: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+  }),
+  
+  utilizationMetrics: Type.Object({
+    fleetUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    driverUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    loadUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    volumeUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    routeUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    facilityUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    networkUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+  }),
+  
+  efficiencyMetrics: Type.Object({
+    milesPerGallon: Type.Number({ minimum: 0 }),
+    packagesPerMile: Type.Number({ minimum: 0 }),
+    stopsPerRoute: Type.Number({ minimum: 0 }),
+    deliveriesPerHour: Type.Number({ minimum: 0 }),
+    pickupsPerHour: Type.Number({ minimum: 0 }),
+    processingSpeed: PerTimeSchema,
+    turnaroundTime: DurationSchema,
+    emptyMileRatio: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+  }),
+  
+  qualityMetrics: Type.Object({
+    packageHandlingScore: Type.Number({ minimum: 0, maximum: 100 }),
+    trackingAccuracy: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    documentAccuracy: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    communicationQuality: Type.Number({ minimum: 0, maximum: 100 }),
+    professionalismScore: Type.Number({ minimum: 0, maximum: 100 }),
+    consistencyScore: Type.Number({ minimum: 0, maximum: 100 }),
+    reliabilityScore: Type.Number({ minimum: 0, maximum: 100 })
+  })
+})
+
+// Peak performance metrics
+export const CarrierPeakPerformanceSchema = Type.Object({
+  peakCapacityMetrics: Type.Object({
+    peakDailyVolume: Type.Number({ minimum: 0 }),
+    peakHourlyVolume: Type.Number({ minimum: 0 }),
+    peakUtilization: Type.Number({ minimum: 0, maximum: 100 }),
+    peakEfficiency: Type.Number({ minimum: 0, maximum: 100 }),
+    sustainablePeakDuration: DurationSchema,
+    peakSeasonMultiplier: Type.Number({ minimum: 1 }),
+    lastPeakDate: Type.Optional(Type.Number()),
+    peakTriggerThreshold: Type.Number({ minimum: 0, maximum: 100 })
+  }),
+  
+  seasonalPerformance: Type.Object({
+    holidayPerformance: Type.Number({ minimum: 0, maximum: 100 }),
+    peakSeasonReliability: Type.Number({ minimum: 0, maximum: 100 }),
+    weatherPerformance: Type.Number({ minimum: 0, maximum: 100 }),
+    capacityFlexibility: Type.Number({ minimum: 0, maximum: 100 }),
+    resourceScaling: Type.Number({ minimum: 0, maximum: 100 }),
+    serviceConsistency: Type.Number({ minimum: 0, maximum: 100 })
+  }),
+  
+  emergencyResponse: Type.Object({
+    responseTime: DurationSchema,
+    recoveryTime: DurationSchema,
+    serviceRestoration: Type.Number({ minimum: 0, maximum: 100 }),
+    alternativeRouting: Type.Number({ minimum: 0, maximum: 100 }),
+    communicationEffectiveness: Type.Number({ minimum: 0, maximum: 100 }),
+    customerRetention: Type.Number({ minimum: 0, maximum: 100 })
+  })
+})
+
+// Financial performance
+export const CarrierFinancialPerformanceSchema = Type.Object({
+  profitabilityMetrics: Type.Object({
+    revenuePerMile: MoneySchema,
+    revenuePerPackage: MoneySchema,
+    operatingMargin: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    netMargin: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    grossMargin: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    returnOnAssets: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    returnOnInvestment: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+  }),
+  
+  costMetrics: Type.Object({
+    costPerMile: MoneySchema,
+    costPerPackage: MoneySchema,
+    costPerDelivery: MoneySchema,
+    fuelCostRatio: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    laborCostRatio: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    vehicleCostRatio: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    facilityCostRatio: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    overheadCostRatio: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' })
+  }),
+  
+  revenueMetrics: Type.Object({
+    totalRevenue: MoneySchema,
+    revenueGrowth: Type.Number({ description: 'percentage' }),
+    revenuePerCustomer: MoneySchema,
+    revenueConcentration: Type.Number({ minimum: 0, maximum: 100, description: 'percentage' }),
+    contractRevenue: MoneySchema,
+    spotRevenue: MoneySchema,
+    valueAddedRevenue: MoneySchema
+  }),
+  
+  cashFlowMetrics: Type.Object({
+    operatingCashFlow: MoneySchema,
+    freeCashFlow: MoneySchema,
+    daysPayableOutstanding: Type.Number({ minimum: 0 }),
+    daysReceivableOutstanding: Type.Number({ minimum: 0 }),
+    cashConversionCycle: Type.Number({ minimum: 0 }),
+    workingCapital: MoneySchema,
+    liquidityRatio: Type.Number({ minimum: 0 })
+  })
+})
+
+// Combined performance schema
+export const CarrierPerformanceSchema = Type.Object({
+  summary: SPPerformanceSummarySchema,
+  metrics: Type.Object({
+    current: CarrierCurrentPerformanceSchema,
+    peak: CarrierPeakPerformanceSchema,
+    financial: Type.Optional(CarrierFinancialPerformanceSchema)
+  })
+})
+
+// Carrier Performance Types
+export type CarrierCurrentPerformance = Static<typeof CarrierCurrentPerformanceSchema>
+export type CarrierPeakPerformance = Static<typeof CarrierPeakPerformanceSchema>
+export type CarrierFinancialPerformance = Static<typeof CarrierFinancialPerformanceSchema>
+export type CarrierPerformance = Static<typeof CarrierPerformanceSchema>