@venulog/phasing-engine-schemas 0.7.6-alpha.0 → 0.7.6

package/dist/vehiclePosition.js

@@ -0,0 +1,237 @@
+import { z } from './zod.js';
+import { PositionSource } from './enums/positionSource.js';
+import { VehicleState } from './enums/vehicleState.js';
+import { VehicleType } from './enums/vehicleType.js';
+import { createSuccessResponseSchema } from './common.js';
+// ============================================================================
+// Enums as Zod schemas
+// ============================================================================
+export const positionSourceSchema = z.enum([
+    PositionSource.GPS,
+    PositionSource.SIMULATED,
+    PositionSource.INFERRED,
+    PositionSource.MANUAL
+]);
+export const vehicleStateSchema = z.enum([
+    VehicleState.BOOKED,
+    VehicleState.APPROACHING,
+    VehicleState.AT_GATE,
+    VehicleState.ENTERING,
+    VehicleState.PARKED,
+    VehicleState.DEPARTING,
+    VehicleState.AT_EXIT,
+    VehicleState.EXITED,
+    VehicleState.HISTORICAL
+]);
+// ============================================================================
+// Site Plan Position Schema (0-100% coordinates)
+// ============================================================================
+export const sitePlanPositionSchema = z
+    .object({
+    x: z.number().min(0).max(100).openapi({
+        description: 'X coordinate on site plan (0-100%)',
+        example: 45.5
+    }),
+    y: z.number().min(0).max(100).openapi({
+        description: 'Y coordinate on site plan (0-100%)',
+        example: 32.8
+    }),
+    heading: z.number().min(0).max(360).optional().openapi({
+        description: 'Direction of travel in degrees (0-360)',
+        example: 90
+    })
+})
+    .openapi('SitePlanPosition');
+// ============================================================================
+// GPS Coordinates Schema
+// ============================================================================
+export const gpsCoordinatesSchema = z
+    .object({
+    latitude: z.number().min(-90).max(90).openapi({
+        description: 'Latitude coordinate',
+        example: 48.8566
+    }),
+    longitude: z.number().min(-180).max(180).openapi({
+        description: 'Longitude coordinate',
+        example: 2.3522
+    })
+})
+    .openapi('GpsCoordinates');
+// ============================================================================
+// Report Position Request (from Mobile App)
+// ============================================================================
+export const reportPositionBodySchema = z
+    .object({
+    booking_id: z.number().int().positive().openapi({
+        description: 'ID of the parking booking',
+        example: 123
+    }),
+    access_token: z.string().min(1).openapi({
+        description: 'JWT access token from booking',
+        example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+    }),
+    latitude: z.number().min(-90).max(90).openapi({
+        description: 'GPS latitude',
+        example: 48.8566
+    }),
+    longitude: z.number().min(-180).max(180).openapi({
+        description: 'GPS longitude',
+        example: 2.3522
+    }),
+    heading: z.number().min(0).max(360).optional().openapi({
+        description: 'Direction of travel in degrees',
+        example: 90
+    }),
+    speed_kmh: z.number().min(0).max(200).optional().openapi({
+        description: 'Speed in km/h',
+        example: 15
+    }),
+    accuracy_meters: z.number().min(0).optional().openapi({
+        description: 'GPS accuracy in meters',
+        example: 5.2
+    }),
+    timestamp: z.string().datetime().optional().openapi({
+        description: 'ISO 8601 timestamp of the position reading',
+        example: '2026-01-04T12:34:56Z'
+    })
+})
+    .openapi('ReportPositionBody');
+// ============================================================================
+// Report Position Response
+// ============================================================================
+export const reportPositionDataSchema = z
+    .object({
+    position_id: z.string().uuid().openapi({
+        description: 'UUID of the created position record',
+        example: '550e8400-e29b-41d4-a716-446655440000'
+    }),
+    received_at: z.string().datetime().openapi({
+        description: 'Server timestamp when position was received',
+        example: '2026-01-04T12:34:56Z'
+    }),
+    site_plan_position: sitePlanPositionSchema.optional().openapi({
+        description: 'Converted position on site plan (if within venue bounds)'
+    })
+})
+    .openapi('ReportPositionData');
+export const reportPositionResponseSchema = createSuccessResponseSchema(reportPositionDataSchema, 'ReportPositionResponse', 'Position report result');
+// ============================================================================
+// Vehicle Position (for Command Center display)
+// ============================================================================
+export const vehiclePositionSchema = z
+    .object({
+    booking_id: z.number().int().positive().openapi({
+        description: 'ID of the parking booking',
+        example: 123
+    }),
+    license_plate: z.string().openapi({
+        description: 'Vehicle license plate',
+        example: 'AB-123-CD'
+    }),
+    vehicle_type: z.enum([VehicleType.PL, VehicleType.VUL, VehicleType.VL]).openapi({
+        description: 'Type of vehicle',
+        example: 'PL'
+    }),
+    company_name: z.string().openapi({
+        description: 'Company name',
+        example: 'ACME Transport'
+    }),
+    stand_number: z.string().optional().openapi({
+        description: 'Exhibition stand number',
+        example: 'H4-23'
+    }),
+    state: vehicleStateSchema.openapi({
+        description: 'Current vehicle state',
+        example: 'parked'
+    }),
+    position: sitePlanPositionSchema.openapi({
+        description: 'Position on site plan'
+    }),
+    speed_kmh: z.number().min(0).optional().openapi({
+        description: 'Current speed in km/h',
+        example: 0
+    }),
+    parking_area_id: z.number().int().positive().optional().openapi({
+        description: 'ID of assigned parking area',
+        example: 5
+    }),
+    parking_area_name: z.string().optional().openapi({
+        description: 'Name of assigned parking area',
+        example: 'Zone A'
+    }),
+    entry_time: z.string().datetime().nullable().openapi({
+        description: 'Time vehicle entered venue',
+        example: '2026-01-04T10:30:00Z'
+    }),
+    last_updated: z.string().datetime().openapi({
+        description: 'Last position update timestamp',
+        example: '2026-01-04T12:34:56Z'
+    }),
+    source: positionSourceSchema.openapi({
+        description: 'How the position was obtained',
+        example: 'gps'
+    })
+})
+    .openapi('VehiclePosition');
+// ============================================================================
+// Get Vehicle Positions Query
+// ============================================================================
+export const getVehiclePositionsQuerySchema = z
+    .object({
+    since: z.string().datetime().optional().openapi({
+        description: 'Only return positions updated after this time',
+        example: '2026-01-04T12:00:00Z'
+    }),
+    include_historical: z
+        .string()
+        .optional()
+        .default('false')
+        .transform((val) => val === 'true')
+        .openapi({
+        description: 'Include recently exited vehicles',
+        example: 'false'
+    }),
+    state: vehicleStateSchema.optional().openapi({
+        description: 'Filter by vehicle state',
+        example: 'parked'
+    })
+})
+    .openapi('GetVehiclePositionsQuery');
+// ============================================================================
+// Get Vehicle Positions Response
+// ============================================================================
+export const vehiclePositionsDataSchema = z
+    .object({
+    event_id: z.number().int().positive().openapi({
+        description: 'Event ID',
+        example: 1
+    }),
+    positions: z.array(vehiclePositionSchema).openapi({
+        description: 'List of vehicle positions'
+    }),
+    total_count: z.number().int().min(0).openapi({
+        description: 'Total number of positions returned',
+        example: 15
+    }),
+    timestamp: z.string().datetime().openapi({
+        description: 'Server timestamp',
+        example: '2026-01-04T12:34:56Z'
+    })
+})
+    .openapi('VehiclePositionsData');
+export const getVehiclePositionsResponseSchema = createSuccessResponseSchema(vehiclePositionsDataSchema, 'GetVehiclePositionsResponse', 'Vehicle positions for an event');
+// ============================================================================
+// Path Parameters
+// ============================================================================
+export const eventIdParamsSchema = z
+    .object({
+    eventId: z
+        .string()
+        .transform((val) => parseInt(val, 10))
+        .pipe(z.number().int().positive())
+        .openapi({
+        description: 'Event ID',
+        example: '1'
+    })
+})
+    .openapi('EventIdParams');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venulog/phasing-engine-schemas",
-  "version": "0.7.6-alpha.0",
+  "version": "0.7.6",
   "description": "Shared schemas and types for Phasing Engine API",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,6 +34,14 @@
       "types": "./dist/parkingArea.d.ts",
       "import": "./dist/parkingArea.js"
     },
+    "./parkingAreaLayer": {
+      "types": "./dist/parkingAreaLayer.d.ts",
+      "import": "./dist/parkingAreaLayer.js"
+    },
+    "./parkingAreaAccess": {
+      "types": "./dist/parkingAreaAccess.d.ts",
+      "import": "./dist/parkingAreaAccess.js"
+    },
     "./enums": {
       "types": "./dist/enums/index.d.ts",
       "import": "./dist/enums/index.js"
@@ -41,6 +49,18 @@
     "./accessToken": {
       "types": "./dist/accessToken.d.ts",
       "import": "./dist/accessToken.js"
+    },
+    "./vehiclePosition": {
+      "types": "./dist/vehiclePosition.d.ts",
+      "import": "./dist/vehiclePosition.js"
+    },
+    "./camera": {
+      "types": "./dist/camera.d.ts",
+      "import": "./dist/camera.js"
+    },
+    "./simulation": {
+      "types": "./dist/simulation.d.ts",
+      "import": "./dist/simulation.js"
     }
   },
   "files": [