@tmlmobilidade/external 20260722.1043.2 → 20260723.1350.16

package/dist/clients/unir/index.d.ts

@@ -0,0 +1,9 @@
+import { UnirVehicleLocationResponse } from './types.js';
+export declare const UnirClient: Readonly<{
+    /**
+     * Fetches vehicle locations from the Unir API.
+     *
+     * @returns {Promise<UnirVehicleLocationResponse>} A promise that resolves with the vehicle locations response.
+     */
+    vehiclePositions: () => Promise<UnirVehicleLocationResponse>;
+}>;

package/dist/clients/unir/index.js

@@ -0,0 +1,36 @@
+/* * */
+/* * */
+const BASE_URL = process.env.UNIR_API_URL;
+const API_KEY = process.env.UNIR_API_KEY;
+async function fetcher(endpoint) {
+    if (!BASE_URL) {
+        throw new Error('Missing UNIR_API_URL environment variable.');
+    }
+    if (!API_KEY) {
+        throw new Error('Missing UNIR_API_KEY environment variable.');
+    }
+    const response = await fetch(`${BASE_URL}${endpoint}`, {
+        headers: {
+            'api-key': API_KEY,
+        },
+    });
+    if (!response.ok) {
+        throw new Error(`Request failed (${response.status}): ${response.statusText}`);
+    }
+    return response;
+}
+/* * */
+const endpoints = {
+    vehiclePositions: '/amp/api-sa/localizacoes-veiculos-direto',
+};
+export const UnirClient = Object.freeze({
+    /**
+     * Fetches vehicle locations from the Unir API.
+     *
+     * @returns {Promise<UnirVehicleLocationResponse>} A promise that resolves with the vehicle locations response.
+     */
+    vehiclePositions: async () => {
+        const response = await fetcher(endpoints.vehiclePositions);
+        return await response.json();
+    },
+});

package/dist/clients/unir/types.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @see GET /amp/api-sa/localizacoes-veiculos-direto
+ */
+export interface UnirVehicleLocationResponse {
+    code: number;
+    message: UnirVehicleLocation[];
+    timestamp: string;
+}
+export interface UnirVehicleLocation {
+    atrasoMaximo: number;
+    atrasoMedio: number;
+    avancoMaximo: number;
+    avancoMedio: number;
+    codigoPublicoLinha: string;
+    codigoServico: string;
+    codigoUltimaParagem: string;
+    estado: string;
+    estadoCumprimento: string;
+    estaNaParagem: boolean;
+    horaUltimoEvento: string;
+    id: string;
+    instanteAtualizacao: string;
+    latitude: number;
+    longitude: number;
+    nomeLinha: string;
+    nomeOperador: string;
+    numAtrasos: number;
+    numAvancos: number;
+    numeroIdentificacaoVeiculo: string;
+    numEventos: number;
+    numExcessosLatenciaChegadaPartidaParagem: number;
+    numExcessosLatenciaInicioFimServico: number;
+    numExcessosLatenciaLocalizacao: number;
+    numTotalSaidasRota: number;
+    operadorId: number;
+    recordedAtTime: string;
+    recordedProcessAtTime: string;
+    stopPointRef: string;
+    temDadosCompletos: boolean;
+    vehicleAtStop: boolean;
+    vehicleRef: string;
+    velocity: number;
+}

package/dist/clients/unir/types.js

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

package/dist/index.d.ts

@@ -58,4 +58,7 @@ export declare const externalClients: Readonly<{
     ttsl: Readonly<{
         vehiclePositions: () => Promise<import("@tmlmobilidade/go-types-gtfs-rt").GtfsRtFeedMessage>;
     }>;
+    unir: Readonly<{
+        vehiclePositions: () => Promise<import("./clients/unir/types.js").UnirVehicleLocationResponse>;
+    }>;
 }>;

package/dist/index.js

@@ -8,6 +8,7 @@ import { MlClient } from './clients/ml/index.js';
 import { MobiClient } from './clients/mobi/index.js';
 import { TcbClient } from './clients/tcb/index.js';
 import { TtslClient } from './clients/ttsl/index.js';
+import { UnirClient } from './clients/unir/index.js';
 /**
  * Collection of external transport agency clients.
  *
@@ -34,4 +35,5 @@ export const externalClients = Object.freeze({
     mobi: MobiClient,
     tcb: TcbClient,
     ttsl: TtslClient,
+    unir: UnirClient,
 });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/external",
-	"version": "20260722.1043.2",
+	"version": "20260723.1350.16",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"