@tmlmobilidade/export-data 20260103.2047.14 → 20260107.1017.45

package/dist/index.js

@@ -8,15 +8,17 @@ import { promptFilterByPatternIds } from './prompts/filter-pattern-ids.js';
 import { promptFilterByStopIds } from './prompts/filter-stop-ids.js';
 import { promptFilterTypes } from './prompts/filter-types.js';
 import { promptFilterByVehicleIds } from './prompts/filter-vehicle-ids.js';
+import { promptHashedShapeIds } from './prompts/hashedshape-ids.js';
 import { exportValidationsByLine } from './tasks/apex-validations/validations-by-line.js';
 import { exportValidationsByPattern } from './tasks/apex-validations/validations-by-pattern.js';
 import { exportValidationsByStopByPattern } from './tasks/apex-validations/validations-by-stop-by-pattern.js';
 import { exportValidationsByStopByTrip } from './tasks/apex-validations/validations-by-stop-by-trip.js';
 import { exportValidationsByStop } from './tasks/apex-validations/validations-by-stop.js';
 import { exportValidationsRaw } from './tasks/apex-validations/validations-raw.js';
+import { exportHashedShapesGeoJSON } from './tasks/hashed-shapes/hashed-shapes-geojson.js';
 import { exportRidesRaw } from './tasks/rides/rides-raw.js';
 import { exportVehicleEventsRaw } from './tasks/vehicle-events/vehicle-events-raw.js';
-import { exportTypeLabels } from './types.js';
+import { exportTypeLabels, exportTypesWithoutFilters } from './types.js';
 import { initExportContext } from './utils/init-context.js';
 import { intro, log, outro, tasks } from '@clack/prompts';
 import { ASCII_CM_SHORT } from '@tmlmobilidade/consts';
@@ -28,7 +30,7 @@ import { ASCII_CM_SHORT } from '@tmlmobilidade/consts';
     const context = initExportContext();
     //
     // Greet the user
-    console.log(ASCII_CM_SHORT);
+    console.log(ASCII_CM_SHORT.replace(/▒/g, '\x1b[33m▒\x1b[0m'));
     intro('Bem-vindo ao exportador de dados da CM!');
     log.info(`O ID desta exportação é: ${context._id}`);
     log.info(`Todos os resultados serão guardados aqui: ${context.output}`);
@@ -38,20 +40,34 @@ import { ASCII_CM_SHORT } from '@tmlmobilidade/consts';
     //
     // Request the export types and which filters to apply
     const exportTypes = await promptExportTypes();
-    const filterTypes = await promptFilterTypes();
     //
-    // For the selected filters, request the filter values
-    if (filterTypes.includes('agency-ids'))
-        context.filters.agency_ids = await promptFilterByAgencyIds();
-    if (filterTypes.includes('line-ids'))
-        context.filters.line_ids = await promptFilterByLineIds();
-    if (filterTypes.includes('pattern-ids'))
-        context.filters.pattern_ids = await promptFilterByPatternIds();
-    if (filterTypes.includes('stop-ids'))
-        context.filters.stop_ids = await promptFilterByStopIds();
-    if (filterTypes.includes('vehicle-ids'))
-        context.filters.vehicle_ids = await promptFilterByVehicleIds();
-    context.dates = await promptFilterByDates();
+    // Check if all selected export types don't require filters
+    const selectedTypesWithoutFilters = exportTypes.filter(type => exportTypesWithoutFilters.includes(type));
+    const shouldSkipFilters = selectedTypesWithoutFilters.length === exportTypes.length && exportTypes.length > 0;
+    //
+    // For hashed_shapes export, prompt for hashedshape IDs
+    let hashedShapeIds = [];
+    if (exportTypes.includes('hashed-shapes-geojson')) {
+        hashedShapeIds = await promptHashedShapeIds();
+    }
+    //
+    // Skip filters and dates if all selected export types don't require them
+    if (!shouldSkipFilters) {
+        const filterTypes = await promptFilterTypes();
+        //
+        // For the selected filters, request the filter values
+        if (filterTypes.includes('agency-ids'))
+            context.filters.agency_ids = await promptFilterByAgencyIds();
+        if (filterTypes.includes('line-ids'))
+            context.filters.line_ids = await promptFilterByLineIds();
+        if (filterTypes.includes('pattern-ids'))
+            context.filters.pattern_ids = await promptFilterByPatternIds();
+        if (filterTypes.includes('stop-ids'))
+            context.filters.stop_ids = await promptFilterByStopIds();
+        if (filterTypes.includes('vehicle-ids'))
+            context.filters.vehicle_ids = await promptFilterByVehicleIds();
+        context.dates = await promptFilterByDates();
+    }
     //
     // Build the tasks array for the selected export types
     await tasks([
@@ -95,6 +111,11 @@ import { ASCII_CM_SHORT } from '@tmlmobilidade/consts';
             task: async (message) => await exportVehicleEventsRaw({ context, message }),
             title: exportTypeLabels['vehicle-events-raw'],
         },
+        {
+            enabled: exportTypes.includes('hashed-shapes-geojson'),
+            task: async (message) => await exportHashedShapesGeoJSON({ context, hashedShapeIds, message }),
+            title: exportTypeLabels['hashed-shapes-geojson'],
+        },
     ]);
     //
     // Terminate the process

package/dist/prompts/export-types.js

@@ -21,6 +21,9 @@ export async function promptExportTypes() {
             '3. Vehicle Events': [
                 { label: exportTypeLabels['vehicle-events-raw'], value: 'vehicle-events-raw' },
             ],
+            '4. HashedShapes': [
+                { label: exportTypeLabels['hashed-shapes-geojson'], value: 'hashed-shapes-geojson' },
+            ],
         },
         required: true,
     });

package/dist/prompts/hashedshape-ids.d.ts

@@ -0,0 +1 @@
+export declare function promptHashedShapeIds(): Promise<string[]>;

package/dist/prompts/hashedshape-ids.js

@@ -0,0 +1,22 @@
+/* * */
+import { note, text } from '@clack/prompts';
+/* * */
+export async function promptHashedShapeIds() {
+    //
+    note('EXPORTAR HASHED SHAPES PARA GEOJSON:\n'
+        + '  • Introduz os HashedShape IDs separados por vírgulas. Exemplo: id1,id2,etc...\n'
+        + '  • Todos os IDs serão exportados para um ficheiro GeoJSON.');
+    const value = await text({
+        message: 'HashedShape IDs:',
+        placeholder: 'id1,id2,etc...',
+        validate(value) {
+            if (!value || value.trim().length === 0) {
+                return 'É necessário introduzir pelo menos um HashedShape ID.';
+            }
+            return;
+        },
+    });
+    if (!value)
+        return [];
+    return value.split(',').map(id => id.trim()).filter(id => id.length > 0);
+}

package/dist/tasks/hashed-shapes/hashed-shapes-geojson.d.ts

@@ -0,0 +1,4 @@
+import { type TaskProps } from '../../types.js';
+export declare function exportHashedShapesGeoJSON({ context, hashedShapeIds, message }: TaskProps & {
+    hashedShapeIds: string[];
+}): Promise<void>;

package/dist/tasks/hashed-shapes/hashed-shapes-geojson.js

@@ -0,0 +1,49 @@
+/* * */
+import { hashedShapesToFeatureCollection } from '../../utils/hashed-shapes-to-geojson.js';
+import { hashedShapes } from '@tmlmobilidade/interfaces';
+import fs from 'node:fs';
+/* * */
+const TASK_ID = 'hashed-shapes-geojson';
+/* * */
+export async function exportHashedShapesGeoJSON({ context, hashedShapeIds, message }) {
+    //
+    message('A iniciar a exportação de HashedShapes para GeoJSON...');
+    //
+    // Fetch all hashed_shapes by their IDs
+    message(`A procurar ${hashedShapeIds.length} HashedShape(s) na base de dados...`);
+    const foundHashedShapes = [];
+    const notFoundIds = [];
+    for (const id of hashedShapeIds) {
+        const hashedShape = await hashedShapes.findById(id);
+        if (hashedShape) {
+            foundHashedShapes.push(hashedShape);
+        }
+        else {
+            notFoundIds.push(id);
+        }
+    }
+    if (notFoundIds.length > 0) {
+        message(`Aviso: ${notFoundIds.length} HashedShape(s) não foram encontrados: ${notFoundIds.join(', ')}`);
+    }
+    if (foundHashedShapes.length === 0) {
+        message('Erro: Nenhum HashedShape foi encontrado.');
+        return;
+    }
+    message(`Encontrados ${foundHashedShapes.length} HashedShape(s).`);
+    //
+    // Convert to GeoJSON FeatureCollection
+    message('A converter para GeoJSON...');
+    const featureCollection = hashedShapesToFeatureCollection(foundHashedShapes);
+    //
+    // Prepare the output directory
+    message(`A preparar a pasta para guardar os resultados...`);
+    if (!fs.existsSync(context.output))
+        fs.mkdirSync(context.output, { recursive: true });
+    //
+    // Write the GeoJSON file
+    const outputFileName = `${context.output}/${TASK_ID}-${hashedShapeIds.join('-')}.geojson`;
+    message(`A escrever o ficheiro GeoJSON: ${outputFileName}`);
+    fs.writeFileSync(outputFileName, JSON.stringify(featureCollection, null, 2), 'utf-8');
+    message(`Exportação concluída! Ficheiro guardado em: ${outputFileName}`);
+    //
+}

package/dist/types.d.ts

@@ -8,8 +8,14 @@ export declare const exportTypeLabels: {
     readonly 'validations-by-stop-by-trip': "1.1. Validações por Stop ID, por Trip ID";
     readonly 'validations-raw': "1.0. Validações em bruto";
     readonly 'vehicle-events-raw': "3.0. Vehicle Events em bruto";
+    readonly 'hashed-shapes-geojson': "4.0. HashedShapes para GeoJSON";
 };
 export type ExportType = keyof typeof exportTypeLabels;
+/**
+ * Export types that don't require filters or dates.
+ * These exports use their own specific input methods (e.g., IDs).
+ */
+export declare const exportTypesWithoutFilters: ExportType[];
 export interface ExportContext {
     _id: string;
     dates: {

package/dist/types.js

@@ -1,3 +1,4 @@
+/* eslint-disable perfectionist/sort-objects */
 /* * */
 /* * */
 export const exportTypeLabels = {
@@ -9,4 +10,12 @@ export const exportTypeLabels = {
     'validations-by-stop-by-trip': '1.1. Validações por Stop ID, por Trip ID',
     'validations-raw': '1.0. Validações em bruto',
     'vehicle-events-raw': '3.0. Vehicle Events em bruto',
+    'hashed-shapes-geojson': '4.0. HashedShapes para GeoJSON',
 };
+/**
+ * Export types that don't require filters or dates.
+ * These exports use their own specific input methods (e.g., IDs).
+ */
+export const exportTypesWithoutFilters = [
+    'hashed-shapes-geojson',
+];

package/dist/utils/hashed-shapes-to-geojson.d.ts

@@ -0,0 +1,3 @@
+import { HashedShape } from '@tmlmobilidade/types';
+import { FeatureCollection, LineString } from 'geojson';
+export declare function hashedShapesToFeatureCollection(hashedShapes: HashedShape | HashedShape[]): FeatureCollection<LineString, GeoJSON.GeoJsonProperties>;

package/dist/utils/hashed-shapes-to-geojson.js

@@ -0,0 +1,29 @@
+/* * */
+/* * */
+export function hashedShapesToFeatureCollection(hashedShapes) {
+    function toFeature(shape) {
+        return {
+            geometry: {
+                coordinates: shape.points.map(point => [point.shape_pt_lon, point.shape_pt_lat]),
+                type: 'LineString',
+            },
+            properties: {
+                agency_id: shape.agency_id,
+                shape_id: shape._id,
+            },
+            type: 'Feature',
+        };
+    }
+    if (Array.isArray(hashedShapes)) {
+        return {
+            features: hashedShapes.map(toFeature),
+            type: 'FeatureCollection',
+        };
+    }
+    else {
+        return {
+            features: [toFeature(hashedShapes)],
+            type: 'FeatureCollection',
+        };
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@tmlmobilidade/export-data",
 	"description": "CLI tool to export data from GO.",
-	"version": "20260103.2047.14",
+	"version": "20260107.1017.45",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"