@de./types 1.0.0

package/src/lsp/order/shipping.ts

@@ -0,0 +1,263 @@
+import { Type, Static } from '@sinclair/typebox'
+import { VehicleSchema } from '../fleet/vehicle'
+import { RoutingSegmentSchema } from '../../routing'
+import { ActionRecordSchema, DateTimeZoneSchema, DurationSchema } from '../../time'
+import { DistanceSchema, VolumeSchema, ServiceLevelSchema } from '../../measure'
+import { RTLocationSchema, AddressSchema } from '../../geo'
+import {
+  BaseOrderStatusSchema,
+  BaseOrderFlowPrioritySchema,
+  OrderAssigneeSchema,
+  LSPBaseOrderSchema
+} from '../../order'
+import {
+	APIErrorSchema,
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory
+} from '../../api'
+import { ShippingOrderProcessSchema } from './flow/processes'
+import { ShippingOrderStageSchema } from './flow/stages'
+
+// LSP Shipping Status (extends existing BaseOrderStatus)
+export const ShippingOrderStatusSchema = Type.Union([
+  ...BaseOrderStatusSchema.anyOf,   // All existing base statuses
+  Type.Literal('DISPATCHED'),
+  Type.Literal('COLLECTED'),
+  Type.Literal('IN_TRANSIT'),
+  Type.Literal('AT_HUB'),
+  Type.Literal('OUT_FOR_DELIVERY'),
+  Type.Literal('DELIVERED'),
+  Type.Literal('ATTEMPTED_DELIVERY'),
+  Type.Literal('DELIVERY_FAILED'),
+  Type.Literal('CUSTOMS_HOLD'),
+  Type.Literal('DAMAGED_IN_TRANSIT'),
+  Type.Literal('LOST'),
+  Type.Literal('RETURNED_TO_SENDER'),
+  Type.Literal('REFUSED_BY_RECIPIENT')
+])
+
+// LSP Shipping Flow (following warehouse order pattern)
+export const ShippingOrderFlowSchema = Type.Object({
+  process: ShippingOrderProcessSchema,
+  stage: ShippingOrderStageSchema,
+  status: ShippingOrderStatusSchema,
+  priority: BaseOrderFlowPrioritySchema
+})
+
+// Main LSP Shipping Order Schema (extends LSPBaseOrder)
+export const ShippingOrderSchema = Type.Intersect([
+  LSPBaseOrderSchema,
+  Type.Object({
+    // LSP-specific flow (following warehouse order pattern)
+    flow: ShippingOrderFlowSchema,
+    // Enhanced route (extends existing RouteSchema)
+    route: Type.Optional(RoutingSegmentSchema),
+    // Vehicle resource assignment
+    vehicle: Type.Optional(VehicleSchema),
+    // Tracking vehicle mileage
+    mileage: Type.Optional(DistanceSchema), // Total kilometers
+    
+    // Shipping fields
+    origin: AddressSchema,
+    destination: AddressSchema,
+    serviceLevel: ServiceLevelSchema,
+
+    // Customer rating for this order
+    customerRating: Type.Optional(Type.Number({ minimum: 1, maximum: 5, description: 'Customer-submitted rating' })),
+
+    // Performance metrics
+    // performance: Type.Optional(Type.Object({
+    //   fuelUsed: Type.Optional(Type.Number({ minimum: 0, description: 'Liters' })),
+    //   carbonFootprint: Type.Optional(Type.Number({ minimum: 0, description: 'CO2 kg' })),
+    //   driverRating: Type.Optional(Type.Number({ minimum: 1, maximum: 5 })),
+    //   customerRating: Type.Optional(Type.Number({ minimum: 1, maximum: 5 }))
+    // }))
+  })
+])
+
+// LSP Shipping Log (following warehouse log pattern)
+export const ShippingLogSchema = Type.Intersect([
+  ActionRecordSchema,
+  Type.Object({
+    flow: ShippingOrderFlowSchema,
+    assignee: OrderAssigneeSchema,
+    location: RTLocationSchema,
+    mileage: Type.Optional(DistanceSchema),
+    // fuelUsed: Type.Optional(Type.Number({ minimum: 0, description: 'Liters' })),
+    reason: Type.Optional(Type.String({ maxLength: 500 })),
+    attachments: Type.Optional(Type.Array(Type.Object({
+      type: Type.Union([
+        Type.Literal('PHOTO'),
+        Type.Literal('SIGNATURE'),
+        Type.Literal('DOCUMENT'),
+        Type.Literal('VOICE_NOTE'),
+        Type.Literal('BARCODE_SCAN')
+      ]),
+      url: Type.String({ format: 'uri' }),
+      description: Type.Optional(Type.String({ maxLength: 200 }))
+    })))
+  })
+])
+
+// Generate TypeScript types
+export type ShippingOrderProcess = Static<typeof ShippingOrderProcessSchema>
+export type ShippingOrderStage = Static<typeof ShippingOrderStageSchema>
+export type ShippingOrderStatus = Static<typeof ShippingOrderStatusSchema>
+export type ShippingOrderFlow = Static<typeof ShippingOrderFlowSchema>
+export type ShippingOrder = Static<typeof ShippingOrderSchema>
+export type ShippingLog = Static<typeof ShippingLogSchema>
+
+// Operational utility schemas for LSP management
+export const DeliveryAttemptSchema = Type.Object({
+  attemptNumber: Type.Number({ minimum: 1, maximum: 5 }),
+  orderId: Type.String(),
+  timestamp: DateTimeZoneSchema,
+  location: Type.Tuple([Type.Number(), Type.Number()]),
+  outcome: Type.Union([
+    Type.Literal('SUCCESSFUL'),
+    Type.Literal('RECIPIENT_NOT_AVAILABLE'),
+    Type.Literal('INCORRECT_ADDRESS'),
+    Type.Literal('REFUSED_BY_RECIPIENT'),
+    Type.Literal('DAMAGED_PACKAGE'),
+    Type.Literal('SECURITY_CONCERNS'),
+    Type.Literal('WEATHER_CONDITIONS'),
+    Type.Literal('VEHICLE_BREAKDOWN'),
+    Type.Literal('ACCESS_DENIED')
+  ]),
+  recipient: Type.Optional(Type.Object({
+    name: Type.String({ maxLength: 100 }),
+    relationship: Type.Union([
+      Type.Literal('ADDRESSEE'),
+      Type.Literal('FAMILY_MEMBER'),
+      Type.Literal('NEIGHBOR'),
+      Type.Literal('BUSINESS_REPRESENTATIVE'),
+      Type.Literal('DOORMAN'),
+      Type.Literal('OTHER')
+    ]),
+    idVerified: Type.Boolean(),
+    signature: Type.Optional(Type.String()),
+    photo: Type.Optional(Type.String({ format: 'uri' }))
+  })),
+  notes: Type.Optional(Type.String({ maxLength: 1000 })),
+  nextAttempt: Type.Optional(Type.Object({
+    scheduledTime: DateTimeZoneSchema,
+    specialInstructions: Type.Optional(Type.String({ maxLength: 500 }))
+  })),
+  driverId: Type.String(),
+  vehicleId: Type.String()
+})
+
+export const PerformanceDashboardSchema = Type.Object({
+  lspId: Type.String(),
+  period: Type.Object({
+    start: DateTimeZoneSchema,
+    end: DateTimeZoneSchema
+  }),
+  deliveryMetrics: Type.Object({
+    totalDeliveries: Type.Number({ minimum: 0 }),
+    successfulDeliveries: Type.Number({ minimum: 0 }),
+    failedDeliveries: Type.Number({ minimum: 0 }),
+    firstAttemptSuccess: Type.Number({ minimum: 0, maximum: 100, description: 'Percentage' }),
+    averageDeliveryTime: DurationSchema, // Hours
+    onTimeDeliveryRate: Type.Number({ minimum: 0, maximum: 100, description: 'Percentage' }),
+    customerSatisfaction: Type.Optional(Type.Number({ minimum: 1, maximum: 5 }))
+  }),
+  operationalMetrics: Type.Object({
+    totalDistance: DistanceSchema,
+    totalFuelUsed: VolumeSchema,
+    averageStopsPerRoute: Type.Number({ minimum: 0 }),
+    routeOptimizationScore: Type.Number({ minimum: 0, maximum: 100 }),
+    driverUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'Percentage' }),
+    vehicleUtilization: Type.Number({ minimum: 0, maximum: 100, description: 'Percentage' })
+  }),
+  costMetrics: Type.Optional(Type.Object({
+    totalOperatingCost: Type.Number({ minimum: 0 }),
+    costPerDelivery: Type.Number({ minimum: 0 }),
+    costPerKilometer: Type.Number({ minimum: 0 }),
+    fuelCost: Type.Number({ minimum: 0 }),
+    maintenanceCost: Type.Number({ minimum: 0 })
+  })),
+  environmentalMetrics: Type.Optional(Type.Object({
+    totalEmissions: Type.Number({ minimum: 0, description: 'CO2 kg' }),
+    emissionsPerDelivery: Type.Number({ minimum: 0, description: 'CO2 kg per delivery' }),
+    emissionsPerKilometer: Type.Number({ minimum: 0, description: 'CO2 grams per km' }),
+    fuelEfficiency: Type.Number({ minimum: 0, description: 'km per liter' })
+  }))
+})
+
+export type DeliveryAttempt      = Static<typeof DeliveryAttemptSchema>
+export type PerformanceDashboard = Static<typeof PerformanceDashboardSchema>
+
+// ─── Request Validation Schemas ───────────────────────────────────────────────
+
+export const ShippingOrderListQuerySchema = Type.Object({
+	stage:  Type.Optional(Type.String()),
+	status: Type.Optional(Type.String()),
+	limit:  Type.Optional(Type.Number()),
+	offset: Type.Optional(Type.Number())
+})
+
+export const ShippingOrderCompleteBodySchema = Type.Object({
+	deliveredAt:       Type.Optional(Type.Number()),
+	recipientName:     Type.Optional(Type.String()),
+	notes:             Type.Optional(Type.String()),
+	signatureRequired: Type.Optional(Type.Boolean())
+})
+
+export const LSPShippingOrderRetrieveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ reference: Type.String() }),
+	response: {
+		200:   APIResponseDataSchemaFactory({ order: LSPBaseOrderSchema, jrtoken: Type.String() }),
+		'4XX': APIErrorSchema
+	}
+}
+
+export const LSPShippingOrderListRVS = {
+	headers:     APIHeadersSchema,
+	querystring: ShippingOrderListQuerySchema,
+	response: {
+		200:   APIResponseDataSchemaFactory({ orders: Type.Array(LSPBaseOrderSchema), total: Type.Number() }),
+		'4XX': APIErrorSchema
+	}
+}
+
+export const LSPShippingOrderAssignOrUnassignRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({
+		reference: Type.String(),
+		action:    Type.Union([Type.Literal('assign'), Type.Literal('unassign')]),
+		to:        Type.Union([Type.Literal('agent'), Type.Literal('operator')])
+	}),
+	body:     Type.Object({ id: Type.String() }),
+	response: {
+		200:   APIResponseBaseSchema,
+		'4XX': APIErrorSchema
+	}
+}
+
+export const LSPShippingOrderRefOnlyRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ reference: Type.String() }),
+	response: {
+		200:   APIResponseBaseSchema,
+		'4XX': APIErrorSchema
+	}
+}
+
+export const LSPShippingOrderCompleteRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ reference: Type.String() }),
+	body:     ShippingOrderCompleteBodySchema,
+	response: {
+		200:   APIResponseDataSchemaFactory({ order: LSPBaseOrderSchema }),
+		'4XX': APIErrorSchema
+	}
+}
+
+export type LSPShippingOrderRetrieveValidation         = { params: Static<typeof LSPShippingOrderRetrieveRVS.params>, response: Static<(typeof LSPShippingOrderRetrieveRVS.response)[200]> }
+export type LSPShippingOrderListValidation             = { querystring: Static<typeof LSPShippingOrderListRVS.querystring>, response: Static<(typeof LSPShippingOrderListRVS.response)[200]> }
+export type LSPShippingOrderAssignOrUnassignValidation = { params: Static<typeof LSPShippingOrderAssignOrUnassignRVS.params>, body: Static<typeof LSPShippingOrderAssignOrUnassignRVS.body>, response: Static<(typeof LSPShippingOrderAssignOrUnassignRVS.response)[200]> }
+export type LSPShippingOrderRefOnlyValidation          = { params: Static<typeof LSPShippingOrderRefOnlyRVS.params>, response: Static<(typeof LSPShippingOrderRefOnlyRVS.response)[200]> }
+export type LSPShippingOrderCompleteValidation         = { params: Static<typeof LSPShippingOrderCompleteRVS.params>, body: Static<typeof LSPShippingOrderCompleteRVS.body>, response: Static<(typeof LSPShippingOrderCompleteRVS.response)[200]> }

package/src/lsp/performance.ts

@@ -0,0 +1,2 @@
+import { Type, Static } from '@sinclair/typebox'
+

package/src/lsp/pod/index.ts

@@ -0,0 +1,323 @@
+import { Type, Static } from '@sinclair/typebox'
+import { ContextSchema } from '../../context'
+import { CoordinatesSchema, AddressSchema } from '../../geo'
+import { ActionRecordSchema, DateTimeZoneSchema } from '../../time'
+import {
+	APIHeadersSchema,
+	APIResponseBaseSchema,
+	APIResponseDataSchemaFactory
+} from '../../api'
+
+// ── Pod Type ──────────────────────────────────────────────────
+
+export const PodTypeSchema = Type.Union([
+	Type.Literal('THERMAL_LOCKER'),  // insulated, food-grade; temperature-monitored
+	Type.Literal('STANDARD_LOCKER'), // uninsulated; general parcels, pharmacy, e-commerce
+	Type.Literal('DRONE_PAD'),       // landing surface + hatch; drone drop/pickup
+	Type.Literal('HYBRID'),          // locker bank + drone hatch on same physical unit
+])
+
+// ── Pod Operational Status ────────────────────────────────────
+
+export const PodStatusSchema = Type.Union([
+	Type.Literal('ACTIVE'),          // accepting orders, fully operational
+	Type.Literal('INACTIVE'),        // configured but not yet operational
+	Type.Literal('RESTOCKING'),      // replenishment in progress; not accepting orders
+	Type.Literal('MAINTENANCE'),     // hardware/software issue; not accepting orders
+	Type.Literal('DECOMMISSIONED'),  // permanently out of service
+])
+
+// ── Fulfillment Modes ─────────────────────────────────────────
+
+export const PodFulfillmentModeSchema = Type.Union([
+	Type.Literal('POD_PICKUP'),  // customer self-collects via PIN/QR
+	Type.Literal('POD_DOOR'),    // swarm rider delivers pod → customer door
+	Type.Literal('DRONE_DROP'),  // drone deposits directly into pod hatch
+])
+
+// ── Compartment Status ────────────────────────────────────────
+
+export const PodCompartmentStatusSchema = Type.Union([
+	Type.Literal('AVAILABLE'),   // empty and ready to accept a package
+	Type.Literal('RESERVED'),    // assigned to an order; awaiting loading
+	Type.Literal('OCCUPIED'),    // loaded; awaiting pickup or rider collection
+	Type.Literal('COLLECTED'),   // package retrieved; ready for reset
+	Type.Literal('FAULTY'),      // sensor/lock failure; excluded from assignment
+])
+
+// ── Drone Hatch Status (DRONE_PAD / HYBRID only) ──────────────
+
+export const DroneHatchStatusSchema = Type.Union([
+	Type.Literal('CLOSED'),    // default sealed state
+	Type.Literal('OPENING'),   // actuator in motion
+	Type.Literal('OPEN'),      // hatch fully open; awaiting approach or deposit
+	Type.Literal('CLOSING'),   // actuator returning to closed
+	Type.Literal('FAULT'),     // mechanical or sensor failure
+])
+
+// ── Compartment ───────────────────────────────────────────────
+
+export const PodCompartmentSchema = Type.Object({
+	id:          Type.String(),
+	podId:       Type.String(),
+	context:     ContextSchema,
+	index:       Type.Number({ minimum: 0, description: 'Physical slot position on the pod unit' }),
+	status:      PodCompartmentStatusSchema,
+	orderId:     Type.Optional(Type.String({ description: 'Order currently using this compartment' })),
+	accessCode:  Type.Optional(Type.String({ minLength: 6, maxLength: 6, description: '6-digit PIN issued to customer or rider for unlock' })),
+	// Drone hatch fields — only populated for DRONE_PAD / HYBRID pods
+	hatchStatus: Type.Optional(DroneHatchStatusSchema),
+	// Lifecycle timestamps
+	reserved: Type.Optional(ActionRecordSchema),
+	occupied: Type.Optional(ActionRecordSchema),
+	expiry: Type.Optional(DateTimeZoneSchema), // Reservation expiry; auto-releases to AVAILABLE
+	metadata:    Type.Optional(Type.Record(Type.String(), Type.Any())),
+	created:     ActionRecordSchema,
+	updated:     Type.Optional(ActionRecordSchema)
+})
+
+// ── Pod ───────────────────────────────────────────────────────
+
+export const PodSchema = Type.Object({
+	id:               Type.String(),
+	context:          ContextSchema,
+	type:             PodTypeSchema,
+	name:             Type.String({ minLength: 1, maxLength: 100 }),
+	status:           PodStatusSchema,
+	zoneId:           Type.String({ description: 'Rally zone this pod is anchored to' }),
+	coordinates:      CoordinatesSchema,
+	address:          AddressSchema,
+	fulfillmentModes: Type.Array(PodFulfillmentModeSchema, { minItems: 1 }),
+	compartmentCount: Type.Number({ minimum: 1, description: 'Total physical compartments on this unit' }),
+	availableCount:   Type.Number({ minimum: 0, description: 'Current free compartments; kept in sync on every mutation' }),
+	acceptingOrders:  Type.Boolean({ description: 'Derived hot-path signal written to Redis for Rally intake' }),
+	// Engine integration references — populated after explicit registration calls
+	hardwareId:       Type.Optional(Type.String({ description: 'IoTSP device binding' })),
+	cpointId:         Type.Optional(Type.String({ description: 'ConsolidationPoint id if registered as relay staging point' })),
+	graphNodeId:      Type.Optional(Type.String({ description: 'Rally Graph POI node id' })),
+	swarmZoneId:      Type.Optional(Type.String({ description: 'Swarm sub-zone id if this pod anchors a swarm zone' })),
+	metadata:         Type.Optional(Type.Record(Type.String(), Type.Any())),
+	created:          ActionRecordSchema,
+	updated:          Type.Optional(ActionRecordSchema),
+})
+
+export const PodUpdateSchema = Type.Object({
+	name:             Type.Optional(Type.String({ minLength: 1, maxLength: 100 })),
+	zoneId:           Type.Optional(Type.String()),
+	address:          Type.Optional(AddressSchema),
+	fulfillmentModes: Type.Optional(Type.Array(PodFulfillmentModeSchema, { minItems: 1 })),
+	hardwareId:       Type.Optional(Type.String()),
+	metadata:         Type.Optional(Type.Record(Type.String(), Type.Any())),
+}, { additionalProperties: false })
+
+// ── TypeScript types ──────────────────────────────────────────
+
+export type PodType              = Static<typeof PodTypeSchema>
+export type PodStatus            = Static<typeof PodStatusSchema>
+export type PodFulfillmentMode   = Static<typeof PodFulfillmentModeSchema>
+export type PodCompartmentStatus = Static<typeof PodCompartmentStatusSchema>
+export type DroneHatchStatus     = Static<typeof DroneHatchStatusSchema>
+export type PodCompartment       = Static<typeof PodCompartmentSchema>
+export type Pod                  = Static<typeof PodSchema>
+export type PodUpdate            = Static<typeof PodUpdateSchema>
+
+// ─── Request Validation Schemas ───────────────────────────────────────────────
+
+export const PodCreateBodySchema = Type.Object({
+	type:             PodTypeSchema,
+	name:             Type.String({ minLength: 1, maxLength: 100 }),
+	zoneId:           Type.String(),
+	coordinates:      CoordinatesSchema,
+	address:          AddressSchema,
+	fulfillmentModes: Type.Array(PodFulfillmentModeSchema, { minItems: 1 }),
+	compartmentCount: Type.Number({ minimum: 1 }),
+	hardwareId:       Type.Optional(Type.String()),
+	metadata:         Type.Optional(Type.Record(Type.String(), Type.Any()))
+})
+
+export const PodStatusUpdateBodySchema = Type.Object({
+	status: PodStatusSchema,
+	reason: Type.Optional(Type.String({ maxLength: 500 }))
+})
+
+export const PodListQuerySchema = Type.Object({
+	type:            Type.Optional(PodTypeSchema),
+	status:          Type.Optional(PodStatusSchema),
+	zoneId:          Type.Optional(Type.String()),
+	acceptingOrders: Type.Optional(Type.Boolean()),
+	limit:           Type.Optional(Type.Number({ minimum: 1, maximum: 200, default: 20 })),
+	offset:          Type.Optional(Type.Number({ minimum: 0, default: 0 }))
+})
+
+export const PodRegisterCpointBodySchema = Type.Object({
+	name:       Type.Optional(Type.String({ maxLength: 100 })),
+	agentNotes: Type.Optional(Type.Array(Type.String({ maxLength: 300 })))
+})
+
+export const PodRegisterGraphNodeBodySchema = Type.Object({
+	agentNotes: Type.Optional(Type.Array(Type.String({ maxLength: 300 })))
+})
+
+export const LSPPodCreateRVS = {
+	headers:  APIHeadersSchema,
+	body:     PodCreateBodySchema,
+	response: APIResponseDataSchemaFactory({ podId: Type.String() })
+}
+
+export const LSPPodRetrieveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	response: APIResponseDataSchemaFactory({ pod: PodSchema })
+}
+
+export const LSPPodListRVS = {
+	headers:     APIHeadersSchema,
+	querystring: PodListQuerySchema,
+	response: APIResponseDataSchemaFactory({
+		pods:   Type.Array(PodSchema),
+		total:  Type.Number(),
+		limit:  Type.Number(),
+		offset: Type.Number()
+	})
+}
+
+export const LSPPodUpdateRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     PodUpdateSchema,
+	response: APIResponseDataSchemaFactory({ pod: PodSchema })
+}
+
+export const LSPPodUpdateStatusRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     PodStatusUpdateBodySchema,
+	response: APIResponseDataSchemaFactory({ pod: PodSchema })
+}
+
+export const LSPPodRemoveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	response: APIResponseBaseSchema
+}
+
+export const LSPPodRegisterCpointRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     PodRegisterCpointBodySchema,
+	response: APIResponseDataSchemaFactory({ cpointId: Type.String() })
+}
+
+export const LSPPodRegisterGraphNodeRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ id: Type.String() }),
+	body:     PodRegisterGraphNodeBodySchema,
+	response: APIResponseDataSchemaFactory({ nodeId: Type.String() })
+}
+
+export type LSPPodCreateValidation            = { headers: Static<typeof LSPPodCreateRVS.headers>, body: Static<typeof LSPPodCreateRVS.body>, response: Static<typeof LSPPodCreateRVS.response> }
+export type LSPPodRetrieveValidation          = { headers: Static<typeof LSPPodRetrieveRVS.headers>, params: Static<typeof LSPPodRetrieveRVS.params>, response: Static<typeof LSPPodRetrieveRVS.response> }
+export type LSPPodListValidation              = { headers: Static<typeof LSPPodListRVS.headers>, querystring: Static<typeof LSPPodListRVS.querystring>, response: Static<typeof LSPPodListRVS.response> }
+export type LSPPodUpdateValidation            = { headers: Static<typeof LSPPodUpdateRVS.headers>, params: Static<typeof LSPPodUpdateRVS.params>, body: Static<typeof LSPPodUpdateRVS.body>, response: Static<typeof LSPPodUpdateRVS.response> }
+export type LSPPodUpdateStatusValidation      = { headers: Static<typeof LSPPodUpdateStatusRVS.headers>, params: Static<typeof LSPPodUpdateStatusRVS.params>, body: Static<typeof LSPPodUpdateStatusRVS.body>, response: Static<typeof LSPPodUpdateStatusRVS.response> }
+export type LSPPodRemoveValidation            = { headers: Static<typeof LSPPodRemoveRVS.headers>, params: Static<typeof LSPPodRemoveRVS.params>, response: Static<typeof LSPPodRemoveRVS.response> }
+export type LSPPodRegisterCpointValidation    = { headers: Static<typeof LSPPodRegisterCpointRVS.headers>, params: Static<typeof LSPPodRegisterCpointRVS.params>, body: Static<typeof LSPPodRegisterCpointRVS.body>, response: Static<typeof LSPPodRegisterCpointRVS.response> }
+export type LSPPodRegisterGraphNodeValidation = { headers: Static<typeof LSPPodRegisterGraphNodeRVS.headers>, params: Static<typeof LSPPodRegisterGraphNodeRVS.params>, body: Static<typeof LSPPodRegisterGraphNodeRVS.body>, response: Static<typeof LSPPodRegisterGraphNodeRVS.response> }
+
+// ─── Compartment & Drone RVS ──────────────────────────────────────────────────
+
+export const LSPPodCompartmentListRVS = {
+	headers:     APIHeadersSchema,
+	params:      Type.Object({ podId: Type.String() }),
+	querystring: Type.Object({
+		status: Type.Optional(PodCompartmentStatusSchema),
+		limit:  Type.Optional(Type.Number({ minimum: 1, maximum: 200, default: 50 })),
+		offset: Type.Optional(Type.Number({ minimum: 0, default: 0 }))
+	}),
+	response: APIResponseDataSchemaFactory({
+		compartments: Type.Array(PodCompartmentSchema),
+		total:        Type.Number(),
+		limit:        Type.Number(),
+		offset:       Type.Number()
+	})
+}
+
+export const LSPPodCompartmentRetrieveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema })
+}
+
+export const LSPPodCompartmentReserveRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	body:     Type.Object({ orderId: Type.String(), expiry: Type.Optional(Type.Number()) }),
+	response: APIResponseDataSchemaFactory({
+		compartment: PodCompartmentSchema,
+		accessCode:  Type.String()
+	})
+}
+
+export const LSPPodCompartmentLoadRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema })
+}
+
+export const LSPPodCompartmentUnlockRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema, accessCode: Type.String() })
+}
+
+export const LSPPodCompartmentCollectRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	body:     Type.Object({ code: Type.String({ minLength: 6, maxLength: 6 }) }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema })
+}
+
+export const LSPPodCompartmentReleaseRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	body:     Type.Object({ reason: Type.Optional(Type.String({ maxLength: 300 })) }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema })
+}
+
+export const LSPPodCompartmentMarkFaultyRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	body:     Type.Object({ reason: Type.String({ maxLength: 500 }) }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema })
+}
+
+export const LSPPodDroneOpenHatchRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema, hatchStatus: DroneHatchStatusSchema })
+}
+
+export const LSPPodDroneCloseHatchRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema, hatchStatus: DroneHatchStatusSchema })
+}
+
+export const LSPPodDroneConfirmDepositRVS = {
+	headers:  APIHeadersSchema,
+	params:   Type.Object({ podId: Type.String(), id: Type.String() }),
+	body:     Type.Object({ orderId: Type.String(), droneId: Type.Optional(Type.String()), depositedAt: Type.Number() }),
+	response: APIResponseDataSchemaFactory({ compartment: PodCompartmentSchema })
+}
+
+export type LSPPodCompartmentListValidation       = { headers: Static<typeof LSPPodCompartmentListRVS.headers>, params: Static<typeof LSPPodCompartmentListRVS.params>, querystring: Static<typeof LSPPodCompartmentListRVS.querystring>, response: Static<typeof LSPPodCompartmentListRVS.response> }
+export type LSPPodCompartmentRetrieveValidation   = { headers: Static<typeof LSPPodCompartmentRetrieveRVS.headers>, params: Static<typeof LSPPodCompartmentRetrieveRVS.params>, response: Static<typeof LSPPodCompartmentRetrieveRVS.response> }
+export type LSPPodCompartmentReserveValidation    = { headers: Static<typeof LSPPodCompartmentReserveRVS.headers>, params: Static<typeof LSPPodCompartmentReserveRVS.params>, body: Static<typeof LSPPodCompartmentReserveRVS.body>, response: Static<typeof LSPPodCompartmentReserveRVS.response> }
+export type LSPPodCompartmentLoadValidation       = { headers: Static<typeof LSPPodCompartmentLoadRVS.headers>, params: Static<typeof LSPPodCompartmentLoadRVS.params>, response: Static<typeof LSPPodCompartmentLoadRVS.response> }
+export type LSPPodCompartmentUnlockValidation     = { headers: Static<typeof LSPPodCompartmentUnlockRVS.headers>, params: Static<typeof LSPPodCompartmentUnlockRVS.params>, response: Static<typeof LSPPodCompartmentUnlockRVS.response> }
+export type LSPPodCompartmentCollectValidation    = { headers: Static<typeof LSPPodCompartmentCollectRVS.headers>, params: Static<typeof LSPPodCompartmentCollectRVS.params>, body: Static<typeof LSPPodCompartmentCollectRVS.body>, response: Static<typeof LSPPodCompartmentCollectRVS.response> }
+export type LSPPodCompartmentReleaseValidation    = { headers: Static<typeof LSPPodCompartmentReleaseRVS.headers>, params: Static<typeof LSPPodCompartmentReleaseRVS.params>, body: Static<typeof LSPPodCompartmentReleaseRVS.body>, response: Static<typeof LSPPodCompartmentReleaseRVS.response> }
+export type LSPPodCompartmentMarkFaultyValidation = { headers: Static<typeof LSPPodCompartmentMarkFaultyRVS.headers>, params: Static<typeof LSPPodCompartmentMarkFaultyRVS.params>, body: Static<typeof LSPPodCompartmentMarkFaultyRVS.body>, response: Static<typeof LSPPodCompartmentMarkFaultyRVS.response> }
+export type LSPPodDroneOpenHatchValidation        = { headers: Static<typeof LSPPodDroneOpenHatchRVS.headers>, params: Static<typeof LSPPodDroneOpenHatchRVS.params>, response: Static<typeof LSPPodDroneOpenHatchRVS.response> }
+export type LSPPodDroneCloseHatchValidation       = { headers: Static<typeof LSPPodDroneCloseHatchRVS.headers>, params: Static<typeof LSPPodDroneCloseHatchRVS.params>, response: Static<typeof LSPPodDroneCloseHatchRVS.response> }
+export type LSPPodDroneConfirmDepositValidation   = { headers: Static<typeof LSPPodDroneConfirmDepositRVS.headers>, params: Static<typeof LSPPodDroneConfirmDepositRVS.params>, body: Static<typeof LSPPodDroneConfirmDepositRVS.body>, response: Static<typeof LSPPodDroneConfirmDepositRVS.response> }