@tmlmobilidade/types 20260605.142.19 → 20260605.1145.54

package/dist/_common/calendar-date.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const CALENDAR_DATE_FORMAT = "yyyy-MM-dd";
+export type CalendarDate = string & {
+    __brand: 'CalendarDate';
+};
+export declare const CalendarDateSchema: z.ZodEffects<z.ZodString, CalendarDate, string>;
+/**
+ * This function validates if a string is a valid calendar date.
+ * Throws an error if the date is invalid.
+ * @param date - The date to be validated.
+ * @returns The given string as a CalendarDate.
+ */
+export declare function validateCalendarDate(date: string): CalendarDate;

package/dist/_common/calendar-date.js

@@ -0,0 +1,20 @@
+/* * */
+import { DateTime } from 'luxon';
+import { z } from 'zod';
+/* * */
+export const CALENDAR_DATE_FORMAT = 'yyyy-MM-dd';
+export const CalendarDateSchema = z
+    .string()
+    .transform(validateCalendarDate);
+/**
+ * This function validates if a string is a valid calendar date.
+ * Throws an error if the date is invalid.
+ * @param date - The date to be validated.
+ * @returns The given string as a CalendarDate.
+ */
+export function validateCalendarDate(date) {
+    const parsedDate = DateTime.fromFormat(date, CALENDAR_DATE_FORMAT);
+    if (!parsedDate.isValid)
+        throw new Error(`Invalid date format '${date}', expected format: ${CALENDAR_DATE_FORMAT}, explanation: ${parsedDate.invalidExplanation}`);
+    return date;
+}

package/dist/_common/index.d.ts

@@ -1,3 +1,4 @@
+export * from './calendar-date.js';
 export * from './comment.js';
 export * from './document.js';
 export * from './environment.js';

package/dist/_common/index.js

@@ -1,3 +1,4 @@
+export * from './calendar-date.js';
 export * from './comment.js';
 export * from './document.js';
 export * from './environment.js';

package/dist/_common/status.d.ts

@@ -31,3 +31,7 @@ export type ValidityStatus = z.infer<typeof ValidityStatusSchema>;
 export declare const SystemStatusValues: readonly ["waiting", "incomplete", "complete", "error"];
 export declare const SystemStatusSchema: z.ZodEnum<["waiting", "incomplete", "complete", "error"]>;
 export type SystemStatus = z.infer<typeof SystemStatusSchema>;
+/***/
+export declare const TicketingStatusValues: readonly ["has_ticketing", "no_ticketing"];
+export declare const TicketingStatusSchema: z.ZodEnum<["has_ticketing", "no_ticketing"]>;
+export type TicketingStatus = z.infer<typeof TicketingStatusSchema>;

package/dist/_common/status.js

@@ -44,3 +44,7 @@ export const ValidityStatusSchema = z.enum(ValidityStatusValues);
 /* SYSTEM STATUS */
 export const SystemStatusValues = ['waiting', 'incomplete', 'complete', 'error'];
 export const SystemStatusSchema = z.enum(SystemStatusValues);
+/***/
+/* TICKETING STATUS */
+export const TicketingStatusValues = ['has_ticketing', 'no_ticketing'];
+export const TicketingStatusSchema = z.enum(TicketingStatusValues);

package/dist/hub/api/index.d.ts

@@ -2,6 +2,7 @@ export * from './alerts/index.js';
 export * from './lines.js';
 export * from './patterns.js';
 export * from './plans/index.js';
+export * from './realtime-eta-gtfs.js';
 export * from './realtime/index.js';
 export * from './shapes.js';
 export * from './stop.js';

package/dist/hub/api/index.js

@@ -2,6 +2,7 @@ export * from './alerts/index.js';
 export * from './lines.js';
 export * from './patterns.js';
 export * from './plans/index.js';
+export * from './realtime-eta-gtfs.js';
 export * from './realtime/index.js';
 export * from './shapes.js';
 export * from './stop.js';

package/dist/hub/api/patterns.d.ts

@@ -38,8 +38,11 @@ export interface HubTrip {
 export interface HubArrival {
     arrival_time: string;
     arrival_time_24h: string;
+    line_id: string;
+    pattern_id: string;
     stop_id: string;
     stop_sequence: number;
+    trip_id: string;
 }
 export interface HubPatternRealtime {
     estimated_arrival: null | string;

package/dist/hub/api/realtime/vehicle-position.d.ts

@@ -2,12 +2,12 @@ import { z } from 'zod';
 export declare const HubVehiclePositionSchema: z.ZodObject<{
     _id: z.ZodString;
     agency_id: z.ZodString;
-    calendar_date: z.ZodEffects<z.ZodString, import("../../../index.js").OperationalDate, string>;
-    created_at: z.ZodEffects<z.ZodNumber, import("../../../index.js").UnixTimestamp, number>;
+    calendar_date: z.ZodEffects<z.ZodString, import("../../../_common/index.js").CalendarDate, string>;
+    created_at: z.ZodEffects<z.ZodNumber, import("../../../_common/unix-timestamp.js").UnixTimestamp, number>;
     geohash: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    latitude: z.ZodEffects<z.ZodNumber, number, number>;
-    longitude: z.ZodEffects<z.ZodNumber, number, number>;
-    received_at: z.ZodEffects<z.ZodNumber, import("../../../index.js").UnixTimestamp, number>;
+    latitude: z.ZodEffects<z.ZodEffects<z.ZodNumber, string, number>, number, number>;
+    longitude: z.ZodEffects<z.ZodEffects<z.ZodNumber, string, number>, number, number>;
+    received_at: z.ZodEffects<z.ZodNumber, import("../../../_common/unix-timestamp.js").UnixTimestamp, number>;
     trip_id: z.ZodString;
     vehicle_id: z.ZodString;
     bearing: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
@@ -32,7 +32,7 @@ export declare const HubVehiclePositionSchema: z.ZodObject<{
     speed: number | null;
     current_status: "INCOMING_AT" | "STOPPED_AT" | "IN_TRANSIT_TO" | null;
     calendar_date: string & {
-        __brand: "OperationalDate";
+        __brand: "CalendarDate";
     };
     geohash?: string | null | undefined;
 }, {

package/dist/hub/api/realtime/vehicle-position.js

@@ -1,6 +1,6 @@
 /* * */
+import { CalendarDateSchema } from '../../../_common/index.js';
 import { UnixTimestampSchema } from '../../../_common/unix-timestamp.js';
-import { OperationalDateSchema } from '../../../index.js';
 import { z } from 'zod';
 /* * */
 export const HubVehiclePositionSchema = z.object({
@@ -8,17 +8,19 @@ export const HubVehiclePositionSchema = z.object({
     // Required Fields
     _id: z.string(),
     agency_id: z.string(),
-    calendar_date: OperationalDateSchema,
+    calendar_date: CalendarDateSchema,
     created_at: UnixTimestampSchema,
     geohash: z.string().nullish(),
     latitude: z.number()
         .min(-90)
         .max(90)
-        .refine(value => value.toFixed(6) === value.toString()),
+        .transform(value => value.toFixed(6))
+        .transform(value => parseFloat(value)),
     longitude: z.number()
         .min(-180)
         .max(180)
-        .refine(value => value.toFixed(6) === value.toString()),
+        .transform(value => value.toFixed(6))
+        .transform(value => parseFloat(value)),
     received_at: UnixTimestampSchema,
     trip_id: z.string(),
     vehicle_id: z.string(),

package/dist/hub/api/realtime-eta-gtfs.d.ts

@@ -0,0 +1,41 @@
+export interface HubGtfsRtStopTimeEvent {
+    delay?: null | number;
+    time?: null | number;
+}
+export interface HubGtfsRtStopTimeUpdate {
+    arrival?: HubGtfsRtStopTimeEvent | null;
+    schedule_relationship?: null | string;
+    stop_id?: null | string;
+    stop_sequence?: null | number;
+}
+export interface HubGtfsRtTripDescriptor {
+    schedule_relationship?: null | string;
+    trip_id?: null | string;
+}
+export interface HubGtfsRtTripUpdate {
+    stop_time_update?: HubGtfsRtStopTimeUpdate[] | null;
+    timestamp?: null | number;
+    trip?: HubGtfsRtTripDescriptor | null;
+    vehicle?: null | {
+        id?: null | string;
+    };
+}
+export interface HubGtfsRtFeedEntity {
+    id?: null | string;
+    stop_time_update?: HubGtfsRtStopTimeUpdate[] | null;
+    timestamp?: null | number;
+    trip?: HubGtfsRtTripDescriptor | null;
+    trip_update?: HubGtfsRtTripUpdate | null;
+    vehicle?: null | {
+        id?: null | string;
+    };
+}
+export interface HubGtfsRtFeedHeader {
+    gtfs_realtime_version?: string;
+    incrementality?: string;
+    timestamp?: number;
+}
+export interface HubGtfsRtFeedMessage {
+    entity: HubGtfsRtFeedEntity[];
+    header: HubGtfsRtFeedHeader;
+}

package/dist/hub/api/realtime-eta-gtfs.js

@@ -0,0 +1,2 @@
+/* * */
+export {};

package/dist/operation/rides/batch-query.d.ts

@@ -15,6 +15,7 @@ export declare const GetRidesBatchQuerySchema: z.ZodObject<{
     stop_ids: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodString, "many">, string[], unknown>>;
     acceptance_status: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["justification_required", "under_review", "accepted", "rejected", "none"]>, "many">, ("none" | "rejected" | "justification_required" | "under_review" | "accepted")[], unknown>>;
     favorites: z.ZodOptional<z.ZodBoolean>;
+    ticketing_status: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["has_ticketing", "no_ticketing"]>, "many">, ("has_ticketing" | "no_ticketing")[], unknown>>;
 }, "strip", z.ZodTypeAny, {
     agency_ids: string[];
     date_end: number & {
@@ -35,6 +36,7 @@ export declare const GetRidesBatchQuerySchema: z.ZodObject<{
     analysis_ended_at_last_stop_grade?: ("error" | "none" | "pass" | "fail" | "skip")[] | undefined;
     analysis_simple_three_vehicle_events_grade?: ("error" | "none" | "pass" | "fail" | "skip")[] | undefined;
     favorites?: boolean | undefined;
+    ticketing_status?: ("has_ticketing" | "no_ticketing")[] | undefined;
 }, {
     date_end: number;
     date_start: number;
@@ -51,5 +53,6 @@ export declare const GetRidesBatchQuerySchema: z.ZodObject<{
     analysis_ended_at_last_stop_grade?: unknown;
     analysis_simple_three_vehicle_events_grade?: unknown;
     favorites?: boolean | undefined;
+    ticketing_status?: unknown;
 }>;
 export type GetRidesBatchQuery = z.infer<typeof GetRidesBatchQuerySchema>;

package/dist/operation/rides/batch-query.js

@@ -1,5 +1,5 @@
 /* * */
-import { DelayStatusSchema, OperationalStatusSchema, SeenStatusSchema } from '../../_common/status.js';
+import { DelayStatusSchema, OperationalStatusSchema, SeenStatusSchema, TicketingStatusSchema } from '../../_common/status.js';
 import { UnixTimestampSchema } from '../../_common/unix-timestamp.js';
 import { RideAcceptanceStatusSchema } from './ride-acceptance.js';
 import { RideAnalysisGradeSchema } from './ride-analysis.js';
@@ -55,4 +55,7 @@ export const GetRidesBatchQuerySchema = z.object({
     favorites: z
         .boolean()
         .optional(),
+    ticketing_status: z
+        .preprocess((val) => (val && typeof val === 'string') ? val.split(',').map(status => status.trim()) : [], z.array(TicketingStatusSchema))
+        .optional(),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/types",
-	"version": "20260605.142.19",
+	"version": "20260605.1145.54",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"