@tmlmobilidade/types 20260411.1248.30 → 20260418.1237.24

package/dist/offer/pattern.js

@@ -2,6 +2,7 @@
 import { CommentSchema } from '../_common/comment.js';
 import { DocumentSchema } from '../_common/document.js';
 import { createGtfsMapper } from '../gtfs-new/mapper.js';
+import { StopIdSchema } from '../stops/stop-id.js';
 import { StopSchema } from '../stops/stop.js';
 import { z } from 'zod';
 import { StopsParametersListSchema } from './parameters.js';
@@ -27,7 +28,7 @@ export const PathSchema = z.object({
     allow_pickup: z.boolean().default(true),
     distance_delta: z.number().nullable().default(null),
     stop: StopSchema.nullable().optional(),
-    stop_id: z.string(),
+    stop_id: StopIdSchema,
     timepoint: z.boolean().default(true),
     zones: z.array(z.string()).optional(),
 });

package/dist/stops/flag.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export declare const StopFlagSchema: z.ZodObject<{
+    agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    is_harmonized: z.ZodDefault<z.ZodBoolean>;
+    short_name: z.ZodString;
+    stop_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    short_name: string;
+    stop_id: string;
+    agency_ids: string[];
+    is_harmonized: boolean;
+}, {
+    short_name: string;
+    stop_id: string;
+    agency_ids?: string[] | undefined;
+    is_harmonized?: boolean | undefined;
+}>;
+export type StopFlag = z.infer<typeof StopFlagSchema>;

package/dist/stops/flag.js

@@ -0,0 +1,9 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const StopFlagSchema = z.object({
+    agency_ids: z.array(z.string()).default([]),
+    is_harmonized: z.boolean().default(false),
+    short_name: z.string(),
+    stop_id: z.string(),
+});

package/dist/stops/index.d.ts

@@ -1,9 +1,11 @@
 export * from './connections.js';
 export * from './equipment.js';
 export * from './facilities.js';
+export * from './flag.js';
 export * from './jurisdiction.js';
 export * from './name-abbreviations.js';
 export * from './parent-station.js';
 export * from './road-type.js';
 export * from './stop-area.js';
+export * from './stop-id.js';
 export * from './stop.js';

package/dist/stops/index.js

@@ -1,9 +1,11 @@
 export * from './connections.js';
 export * from './equipment.js';
 export * from './facilities.js';
+export * from './flag.js';
 export * from './jurisdiction.js';
 export * from './name-abbreviations.js';
 export * from './parent-station.js';
 export * from './road-type.js';
 export * from './stop-area.js';
+export * from './stop-id.js';
 export * from './stop.js';

package/dist/stops/stop-id.d.ts

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export declare const StopIdSchema: z.ZodNumber;
+/**
+ * Represents a Stop ID, which is a unique identifier
+ * for a stop in the transportation system.
+ */
+export type StopId = z.infer<typeof StopIdSchema>;
+/**
+ * Validates the structure of a Stop ID.
+ * @param value The value to validate as a Stop ID.
+ * @returns The validated Stop ID if valid, or false if invalid.
+ */
+export declare function validateStopIdStructure(value?: null | number | StopId | string): false | StopId;

package/dist/stops/stop-id.js

@@ -0,0 +1,29 @@
+/* * */
+import { z } from 'zod';
+/* * */
+export const StopIdSchema = z
+    .number()
+    .min(100_000)
+    .max(999_999);
+/**
+ * Validates the structure of a Stop ID.
+ * @param value The value to validate as a Stop ID.
+ * @returns The validated Stop ID if valid, or false if invalid.
+ */
+export function validateStopIdStructure(value) {
+    // Return false if no value is provided
+    if (!value)
+        return false;
+    // Transform the value into a number if it's a string
+    if (typeof value === 'string')
+        value = parseInt(value, 10);
+    // Return false if the value is not a number or is NaN
+    if (typeof value !== 'number' || isNaN(value))
+        return false;
+    // Return false if the value is outside the valid range for Stop IDs
+    if (value < 100_000 || value > 999_999)
+        return false;
+    // Return the value as a Stop ID
+    // if it passes all checks.
+    return value;
+}

package/dist/stops/stop.d.ts

@@ -6,13 +6,31 @@ export declare const StopSchema: z.ZodObject<{
     updated_at: z.ZodEffects<z.ZodNumber, import("../_common/unix-timestamp.js").UnixTimestamp, number>;
     updated_by: z.ZodOptional<z.ZodString>;
 } & {
-    _id: z.ZodString;
+    _id: z.ZodNumber;
+    flags: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        is_harmonized: z.ZodDefault<z.ZodBoolean>;
+        short_name: z.ZodString;
+        stop_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        short_name: string;
+        stop_id: string;
+        agency_ids: string[];
+        is_harmonized: boolean;
+    }, {
+        short_name: string;
+        stop_id: string;
+        agency_ids?: string[] | undefined;
+        is_harmonized?: boolean | undefined;
+    }>, "many">>;
     is_deleted: z.ZodDefault<z.ZodBoolean>;
     jurisdiction: z.ZodDefault<z.ZodEnum<["ip", "municipality", "other", "unknown"]>>;
     legacy_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    legacy_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     lifecycle_status: z.ZodDefault<z.ZodEnum<["draft", "active", "inactive", "provisional", "seasonal", "voided"]>>;
     name: z.ZodString;
     new_name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    previous_go_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     short_name: z.ZodString;
     tts_name: z.ZodString;
     district_id: z.ZodString;
@@ -259,7 +277,7 @@ export declare const StopSchema: z.ZodObject<{
     }>, "many">>;
     observations: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    _id: string;
+    _id: number;
     created_at: number & {
         __brand: "UnixTimestamp";
     };
@@ -329,11 +347,19 @@ export declare const StopSchema: z.ZodObject<{
     parish_id: string | null;
     shelter_code: string | null;
     shelter_maintainer: string | null;
+    flags: {
+        short_name: string;
+        stop_id: string;
+        agency_ids: string[];
+        is_harmonized: boolean;
+    }[];
     is_deleted: boolean;
     jurisdiction: "unknown" | "municipality" | "ip" | "other";
     legacy_id: string | null;
+    legacy_ids: string[];
     lifecycle_status: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided";
     new_name: string | null;
+    previous_go_id: string | null;
     tts_name: string;
     district_id: string;
     locality_id: string | null;
@@ -357,7 +383,7 @@ export declare const StopSchema: z.ZodObject<{
     image_ids: string[];
     updated_by?: string | undefined;
 }, {
-    _id: string;
+    _id: number;
     created_at: number;
     updated_at: number;
     name: string;
@@ -414,11 +440,19 @@ export declare const StopSchema: z.ZodObject<{
     parish_id?: string | null | undefined;
     shelter_code?: string | null | undefined;
     shelter_maintainer?: string | null | undefined;
+    flags?: {
+        short_name: string;
+        stop_id: string;
+        agency_ids?: string[] | undefined;
+        is_harmonized?: boolean | undefined;
+    }[] | undefined;
     is_deleted?: boolean | undefined;
     jurisdiction?: "unknown" | "municipality" | "ip" | "other" | undefined;
     legacy_id?: string | null | undefined;
+    legacy_ids?: string[] | undefined;
     lifecycle_status?: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided" | undefined;
     new_name?: string | null | undefined;
+    previous_go_id?: string | null | undefined;
     locality_id?: string | null | undefined;
     bench_status?: "unknown" | "not_applicable" | "missing" | "damaged" | "ok" | undefined;
     electricity_status?: "unknown" | "available" | "unavailable" | undefined;
@@ -446,13 +480,31 @@ export declare const CreateStopSchema: z.ZodObject<Omit<{
     updated_at: z.ZodEffects<z.ZodNumber, import("../_common/unix-timestamp.js").UnixTimestamp, number>;
     updated_by: z.ZodOptional<z.ZodString>;
 } & {
-    _id: z.ZodString;
+    _id: z.ZodNumber;
+    flags: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        is_harmonized: z.ZodDefault<z.ZodBoolean>;
+        short_name: z.ZodString;
+        stop_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        short_name: string;
+        stop_id: string;
+        agency_ids: string[];
+        is_harmonized: boolean;
+    }, {
+        short_name: string;
+        stop_id: string;
+        agency_ids?: string[] | undefined;
+        is_harmonized?: boolean | undefined;
+    }>, "many">>;
     is_deleted: z.ZodDefault<z.ZodBoolean>;
     jurisdiction: z.ZodDefault<z.ZodEnum<["ip", "municipality", "other", "unknown"]>>;
     legacy_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    legacy_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     lifecycle_status: z.ZodDefault<z.ZodEnum<["draft", "active", "inactive", "provisional", "seasonal", "voided"]>>;
     name: z.ZodString;
     new_name: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    previous_go_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     short_name: z.ZodString;
     tts_name: z.ZodString;
     district_id: z.ZodString;
@@ -762,11 +814,19 @@ export declare const CreateStopSchema: z.ZodObject<Omit<{
     parish_id: string | null;
     shelter_code: string | null;
     shelter_maintainer: string | null;
+    flags: {
+        short_name: string;
+        stop_id: string;
+        agency_ids: string[];
+        is_harmonized: boolean;
+    }[];
     is_deleted: boolean;
     jurisdiction: "unknown" | "municipality" | "ip" | "other";
     legacy_id: string | null;
+    legacy_ids: string[];
     lifecycle_status: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided";
     new_name: string | null;
+    previous_go_id: string | null;
     tts_name: string;
     district_id: string;
     locality_id: string | null;
@@ -844,11 +904,19 @@ export declare const CreateStopSchema: z.ZodObject<Omit<{
     parish_id?: string | null | undefined;
     shelter_code?: string | null | undefined;
     shelter_maintainer?: string | null | undefined;
+    flags?: {
+        short_name: string;
+        stop_id: string;
+        agency_ids?: string[] | undefined;
+        is_harmonized?: boolean | undefined;
+    }[] | undefined;
     is_deleted?: boolean | undefined;
     jurisdiction?: "unknown" | "municipality" | "ip" | "other" | undefined;
     legacy_id?: string | null | undefined;
+    legacy_ids?: string[] | undefined;
     lifecycle_status?: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided" | undefined;
     new_name?: string | null | undefined;
+    previous_go_id?: string | null | undefined;
     locality_id?: string | null | undefined;
     bench_status?: "unknown" | "not_applicable" | "missing" | "damaged" | "ok" | undefined;
     electricity_status?: "unknown" | "available" | "unavailable" | undefined;
@@ -1097,11 +1165,29 @@ export declare const UpdateStopSchema: z.ZodObject<{
     parish_id: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
     shelter_code: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
     shelter_maintainer: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    flags: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        agency_ids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        is_harmonized: z.ZodDefault<z.ZodBoolean>;
+        short_name: z.ZodString;
+        stop_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        short_name: string;
+        stop_id: string;
+        agency_ids: string[];
+        is_harmonized: boolean;
+    }, {
+        short_name: string;
+        stop_id: string;
+        agency_ids?: string[] | undefined;
+        is_harmonized?: boolean | undefined;
+    }>, "many">>>;
     is_deleted: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     jurisdiction: z.ZodOptional<z.ZodDefault<z.ZodEnum<["ip", "municipality", "other", "unknown"]>>>;
     legacy_id: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    legacy_ids: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodString, "many">>>;
     lifecycle_status: z.ZodOptional<z.ZodDefault<z.ZodEnum<["draft", "active", "inactive", "provisional", "seasonal", "voided"]>>>;
     new_name: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
+    previous_go_id: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
     tts_name: z.ZodOptional<z.ZodString>;
     district_id: z.ZodOptional<z.ZodString>;
     locality_id: z.ZodOptional<z.ZodDefault<z.ZodNullable<z.ZodString>>>;
@@ -1187,11 +1273,19 @@ export declare const UpdateStopSchema: z.ZodObject<{
     parish_id?: string | null | undefined;
     shelter_code?: string | null | undefined;
     shelter_maintainer?: string | null | undefined;
+    flags?: {
+        short_name: string;
+        stop_id: string;
+        agency_ids: string[];
+        is_harmonized: boolean;
+    }[] | undefined;
     is_deleted?: boolean | undefined;
     jurisdiction?: "unknown" | "municipality" | "ip" | "other" | undefined;
     legacy_id?: string | null | undefined;
+    legacy_ids?: string[] | undefined;
     lifecycle_status?: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided" | undefined;
     new_name?: string | null | undefined;
+    previous_go_id?: string | null | undefined;
     tts_name?: string | undefined;
     district_id?: string | undefined;
     locality_id?: string | null | undefined;
@@ -1265,11 +1359,19 @@ export declare const UpdateStopSchema: z.ZodObject<{
     parish_id?: string | null | undefined;
     shelter_code?: string | null | undefined;
     shelter_maintainer?: string | null | undefined;
+    flags?: {
+        short_name: string;
+        stop_id: string;
+        agency_ids?: string[] | undefined;
+        is_harmonized?: boolean | undefined;
+    }[] | undefined;
     is_deleted?: boolean | undefined;
     jurisdiction?: "unknown" | "municipality" | "ip" | "other" | undefined;
     legacy_id?: string | null | undefined;
+    legacy_ids?: string[] | undefined;
     lifecycle_status?: "draft" | "active" | "inactive" | "provisional" | "seasonal" | "voided" | undefined;
     new_name?: string | null | undefined;
+    previous_go_id?: string | null | undefined;
     tts_name?: string | undefined;
     district_id?: string | undefined;
     locality_id?: string | null | undefined;

package/dist/stops/stop.js

@@ -6,20 +6,25 @@ import { UnixTimeStampSchema } from '../_common/unix-timestamp.js';
 import { StopConnectionSchema } from './connections.js';
 import { StopEquipmentSchema } from './equipment.js';
 import { StopFacilitySchema } from './facilities.js';
+import { StopFlagSchema } from './flag.js';
 import { StopJurisdictionSchema } from './jurisdiction.js';
 import { StopRoadTypeSchema } from './road-type.js';
+import { StopIdSchema } from './stop-id.js';
 import { z } from 'zod';
 /* * */
 export const StopSchema = DocumentSchema.extend({
     //
     // General
-    _id: z.string(),
+    _id: StopIdSchema,
+    flags: z.array(StopFlagSchema).default([]),
     is_deleted: z.boolean().default(false),
     jurisdiction: StopJurisdictionSchema.default('unknown'),
     legacy_id: z.string().nullable().default(null),
+    legacy_ids: z.array(z.string()).default([]),
     lifecycle_status: LifecycleStatusSchema.default('draft'),
     name: z.string().min(2).max(100),
     new_name: z.string().min(5).max(100).nullable().default(null),
+    previous_go_id: z.string().nullable().default(null),
     short_name: z.string().min(2).max(55),
     tts_name: z.string(),
     //

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/types",
-	"version": "20260411.1248.30",
+	"version": "20260418.1237.24",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"
@@ -44,7 +44,7 @@
 	"devDependencies": {
 		"@tmlmobilidade/tsconfig": "*",
 		"@types/luxon": "3.7.1",
-		"@types/node": "25.5.2",
+		"@types/node": "25.6.0",
 		"resolve-tspaths": "0.8.23",
 		"tsc-watch": "7.2.0",
 		"typescript": "5.9.3"