Add type for departure board data

schemas/api/stations/board.json

@@ -0,0 +1,232 @@
+{
+    "$id": "https://schema.owlboard.info/api/stations/board.schema.json",
+    "$schema": "https://json-schema.org/draft-07/schema#",
+    "title": "StationsBoard",
+    "description": "Arr/Dep/Pass Board",
+    "type": "object",
+    "properties": {
+        "n": {
+            "type": "string",
+            "title": "Location Name",
+            "description": "The name of the location"
+        },
+        "o": {
+            "type": "string",
+            "title": "Operator (if station)",
+            "description": "The operator of the station, if the location is a station"
+        },
+        "s": {
+            "title": "Services",
+            "type": "array",
+            "items": {
+                "$ref": "#/definitions/boardService"
+            }
+        },
+        "m": {
+            "type": "array",
+            "title": "messages",
+            "items": {
+                "$ref": "#/definitions/boardMsgs"
+            }
+        }
+    },
+    "required": [
+        "n"
+    ],
+    "definitions": {
+        "boardService": {
+            "type": "object",
+            "required": [
+                "r",
+                "o",
+                "ip",
+                "og",
+                "dt"
+            ],
+            "properties": {
+                "r": {
+                    "type": "string",
+                    "title": "RID",
+                    "description": "Services RID"
+                },
+                "o": {
+                    "type": "string",
+                    "title": "TOC",
+                    "description": "The services operator code"
+                },
+                "ip": {
+                    "type": "boolean",
+                    "title": "isPassenger",
+                    "description": "Whether this is a passenger service"
+                },
+                "og": {
+                    "type": "object",
+                    "title": "Origin",
+                    "description": "The services origin",
+                    "required": ["t", "n"],
+                    "properties": {
+                        "t": {
+                            "type": "string",
+                            "title": "TIPLOC",
+                            "description": "The Origin TIPLOC"
+                        },
+                        "n": {
+                            "type": "string",
+                            "title": "Name",
+                            "description": "The Origin Name"
+                        }
+                    }
+                },
+                "dt": {
+                    "type": "object",
+                    "title": "Destination",
+                    "description": "The services destination",
+                    "required": ["t", "n"],
+                    "properties": {
+                        "t": {
+                            "type": "string",
+                            "title": "TIPLOC",
+                            "description": "The Destination TIPLOC"
+                        },
+                        "n": {
+                            "type": "string",
+                            "title": "Name",
+                            "description": "The Destination Name"
+                        }
+                    }
+                },
+                "sta": {
+                    "type": "string",
+                    "format": "date-time",
+                    "title": "Scheduled Arrival",
+                    "description": "The scheduled arrival time of the service (public or working)"
+                },
+                "ata": {
+                    "type": "string",
+                    "format": "date-time",
+                    "title": "Actual Arrival",
+                    "description": "The actual arrival time of the service"
+                },
+                "eta": {
+                    "type": "string",
+                    "format": "date-time",
+                    "title": "Estimated Arrival",
+                    "description": "The estimated arrival time of the service"
+                },
+                "std": {
+                    "type": "string",
+                    "format": "date-time",
+                    "title": "Scheduled Departure",
+                    "description": "The scheduled departure time of the service (public or working)"
+                },
+                "atd": {
+                    "type": "string",
+                    "format": "date-time",
+                    "title": "Actual Departure",
+                    "description": "The actual departure time of the service"
+                },
+                "etd": {
+                    "type": "string",
+                    "format": "date-time",
+                    "title": "Estimated Departure",
+                    "description": "The estimated departure time of the service"
+                },
+                "p": {
+                    "type": "string",
+                    "title": "Platform",
+                    "description": "The platform for this service"
+                },
+                "pc": {
+                    "type": "boolean",
+                    "title": "Platform Changed",
+                    "description": "Whether the platform has changed (alteration)"
+                },
+                "ps": {
+                    "type": "boolean",
+                    "title": "Platform suppressed",
+                    "description": "Whether the platform number is suppressed"
+                },
+                "c": {
+                    "type": "boolean",
+                    "title": "Cancelled",
+                    "description": "Whether the service is cancelled at this location"
+                },
+                "da": {
+                    "type": "boolean",
+                    "title": "Delayed Arrival",
+                    "description": "Whether to show the service as delayed arrival"
+                },
+                "dd": {
+                    "type": "boolean",
+                    "title": "Delayed Departure",
+                    "description": "Whether to show the service as delayed departure"
+                },
+                "cr": {
+                    "$ref": "#/definitions/reason"
+                },
+                "dr": {
+                    "$ref": "#/definitions/reason"
+                },
+                "act": {
+                    "type": "string",
+                    "title": "Activities",
+                    "description": "Activities at this location"
+                },
+                "f": {
+                    "$ref": "#/definitions/formation"
+                }
+            }
+        },
+        "reason": {
+            "type": "object",
+            "properties": {
+                "r": {
+                    "type": "string",
+                    "title": "Reason",
+                    "description": "The textual reason"
+                },
+                "l": {
+                    "type": "string",
+                    "title": "Location",
+                    "description": "The location the reason occurred"
+                },
+                "n": {
+                    "type": "boolean",
+                    "title": "Near",
+                    "description": "Whether the reason occured NEAR LOCATION (else AT LOCATION)"
+                }
+            }
+        },
+        "formation": {
+            "type": "object",
+            "properties": {
+                "fid": {
+                    "type": "string",
+                    "title": "FID",
+                    "description": "The serviced FID at this location"
+                }
+            }
+        },
+        "boardMsgs": {
+            "type": "object",
+            "required": ["t"],
+            "properties": {
+                "t": {
+                    "type": "string",
+                    "title": "Text",
+                    "description": "The message text"
+                },
+                "l": {
+                    "type": "string",
+                    "title": "Link",
+                    "description": "The NRE Link to the incident page"
+                },
+                "lt": {
+                    "type": "string",
+                    "title": "Link Text",
+                    "description": "The text to display as the link"
+                }
+            }
+        }
+    }
+}

schemas/api/trains/TrainByHeadcode.json

@@ -36,6 +36,12 @@
             "description": "The TOC operating the service",
             "minLength": 2,
             "maxLength": 2
+        },
+        "ct": {
+            "type": "boolean",
+            "title": "Cancelled Throughout",
+            "name": "Cancelled Throughout",
+            "description": "Whether the train is cancelled throughout"
         }
     }
 }

schemas/api/trains/TrainDetails.json

@@ -1,12 +1,7 @@
 {
     "$schema": "https://json-schema.org/draft-07/schema#",
-    "title": "TrainByHeadcodeResponse",
+    "title": "TrainDetailsResponse",
     "$defs": {
-        "DateTimeTZ": {
-            "type": "string",
-            "format": "date-time",
-            "description": "An ISO-8601 timestamp"
-        },
         "ServiceLocation": {
             "type": "object",
             "description": "A specific location along the services journey",
@@ -67,47 +62,58 @@
                     "description": "The formation ID at this location"
                 },
                 "pta": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Public time of arrival"
                 },
                 "wta": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Working time of arrival"
                 },
                 "wtp": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Working time of pass"
                 },
                 "ptd": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Public time of departure"
                 },
                 "wtd": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Working time of departure"
                 },
                 "eta": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Estimated time of arrival"
                 },
                 "etd": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Estimated time of departure"
                 },
                 "etp": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Estimated time of pass"
                 },
                 "ata": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Actual time of arrival"
                 },
                 "atd": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Actual time of departure"
                 },
                 "atp": {
-                    "$ref": "#/$defs/DateTimeTZ",
+                    "type": "string",
+                    "format": "date-time",
                     "title": "Actual time of pass"
                 }
             },
@@ -122,23 +128,6 @@
             "type": "object",
             "additionalProperties": false,
             "properties": {
-                "r": {
-                    "type": "string",
-                    "title": "RID",
-                    "description": "The RID of the service",
-                    "maxLength": 16
-                },
-                "u": {
-                    "title": "UID",
-                    "description": "The UID of the service",
-                    "type": "string"
-                },
-                "s": {
-                    "title": "SSD",
-                    "description": "The SSD of the service",
-                    "type": "string",
-                    "format": "date"
-                },
                 "h": {
                     "title": "train_id",
                     "description": "Headcode",
@@ -160,7 +149,7 @@
                 },
                 "cr": {
                     "title": "Cancel Reason",
-                    "type": "integer"
+                    "type": "string"
                 },
                 "cl": {
                     "title": "Cancel Location",
@@ -174,7 +163,7 @@
                 },
                 "dr": {
                     "title": "Delay Reason",
-                    "type": "integer"
+                    "type": "string"
                 },
                 "dl": {
                     "title": "Delay Location",
@@ -202,7 +191,7 @@
                     "type": "string"
                 }
             },
-            "required": ["r", "s", "h", "t", "ip", "ic"]
+            "required": ["h", "t", "ip", "ic"]
         },
         "locations": {
             "type": "array",
@@ -210,6 +199,9 @@
             "items": {
                 "$ref": "#/$defs/ServiceLocation"
             }
+        },
+        "pis": {
+            "description": "PIS data for the service (if available)"
         }
     }
 }

scripts/build.sh

@@ -15,10 +15,10 @@ for file in $FILES; do
     clean_name=$(echo "${file#schemas/}" | sed 's/\//_/g' | sed 's/\.json//g')
 
     # OGenerate TS
-    npx --yes json-schema-to-typescript "$file" > "gen/ts/${clean_name}.ts"
+    npx --yes json-schema-to-typescript "$file" > "./gen/ts/${clean_name}.ts"
     
     # Generate Go
-    go-jsonschema -p contracts "$file" > "gen/go/models/${clean_name}.go"
+    go-jsonschema -p contracts "$file" > "./gen/go/models/${clean_name}.go"
 done
 
 echo "✅ Generated single TS package in gen/ts"