@tmlmobilidade/go-interfaces-labdb 20260722.1043.2 → 20260723.1350.16

package/dist/databases/operation.d.ts

@@ -1,8 +1,9 @@
 import { ClickHouseInterfaceTemplate } from '../interface.template.js';
 import { ClickHouseClient } from '@tmlmobilidade/go-clients-clickhouse';
-import { type SimplifiedVehicleEvent } from '@tmlmobilidade/types';
+import { type SimplifiedVehicleEvent } from '@tmlmobilidade/go-types-vehicle-events';
 export declare class OperationDatabase {
     readonly vehicleEvents: ClickHouseInterfaceTemplate<SimplifiedVehicleEvent>;
     private readonly databaseName;
     constructor(instance: ClickHouseClient);
+    init(): Promise<void>;
 }

package/dist/databases/operation.js

@@ -1,21 +1,20 @@
 /* * */
 import { ClickHouseInterfaceTemplate } from '../interface.template.js';
-import { simplifiedVehicleEventSchema } from '../types/operation.js';
+import { simplifiedVehicleEventTableSchema } from '../schemas/operation.js';
 /* * */
 export class OperationDatabase {
     //
-    //
-    // Collections
     vehicleEvents;
-    //
     databaseName = 'operation';
     constructor(instance) {
-        // Create collection interfaces
-        this.vehicleEvents = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'simplified_vehicle_events', simplifiedVehicleEventSchema, {
+        this.vehicleEvents = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'simplified_vehicle_events', simplifiedVehicleEventTableSchema, {
             engine: 'ReplacingMergeTree(created_at)',
             orderBy: ['operational_date', 'trip_id', 'vehicle_id', 'agency_id', 'created_at'],
             partitionBy: 'toYYYYMM(fromUnixTimestamp64Milli(created_at))',
             primaryKey: ['operational_date', 'trip_id', 'vehicle_id'],
         });
     }
+    async init() {
+        await this.vehicleEvents.init();
+    }
 }

package/dist/databases/performance.d.ts

@@ -5,4 +5,5 @@ export declare class PerformanceDatabase {
     readonly demandByAgencyByOperationalDate: ClickHouseInterfaceTemplate<DemandByAgencyByOperationalDate>;
     private readonly databaseName;
     constructor(instance: ClickHouseClient);
+    init(): Promise<void>;
 }

package/dist/databases/performance.js

@@ -1,21 +1,19 @@
 /* * */
 import { ClickHouseInterfaceTemplate } from '../interface.template.js';
-import { demandByAgencyByOperationalDateSchema } from '../types/performance.js';
+import { demandByAgencyByOperationalDateTableSchema } from '../schemas/performance.js';
 /* * */
 export class PerformanceDatabase {
     //
-    //
-    // Tables
     demandByAgencyByOperationalDate;
-    //
     databaseName = 'performance';
     constructor(instance) {
-        //
-        // Create the table interfaces
-        this.demandByAgencyByOperationalDate = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'demand_by_agency_by_operational_date', demandByAgencyByOperationalDateSchema, {
+        this.demandByAgencyByOperationalDate = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'demand_by_agency_by_operational_date', demandByAgencyByOperationalDateTableSchema, {
             engine: 'ReplacingMergeTree(updated_at)',
             orderBy: ['operational_date', 'agency_id'],
             partitionBy: 'intDiv(operational_date, 100)',
         });
     }
+    async init() {
+        await this.demandByAgencyByOperationalDate.init();
+    }
 }

package/dist/databases/simplified-apex.d.ts

@@ -10,5 +10,6 @@ export declare class SimplifiedApexDatabase {
     readonly sales: ClickHouseInterfaceTemplate<SimplifiedApexOnBoardSale>;
     readonly validations: ClickHouseInterfaceTemplate<SimplifiedApexValidation>;
     private readonly databaseName;
-    constructor(instance: ClickHouseClient);
+    constructor(client: ClickHouseClient);
+    init(): Promise<void>;
 }

package/dist/databases/simplified-apex.js

@@ -1,11 +1,9 @@
 /* * */
 import { ClickHouseInterfaceTemplate } from '../interface.template.js';
-import { simplifiedApexBankingTapSchema, simplifiedApexInspectionDecisionSchema, simplifiedApexInspectionSchema, simplifiedApexLocationSchema, simplifiedApexOnBoardRefundSchema, simplifiedApexOnBoardSaleSchema, simplifiedApexValidationSchema } from '../types/simplified-apex.js';
+import { simplifiedApexBankingTapTableSchema, simplifiedApexInspectionDecisionTableSchema, simplifiedApexInspectionTableSchema, simplifiedApexLocationTableSchema, simplifiedApexOnBoardRefundTableSchema, simplifiedApexOnBoardSaleTableSchema, simplifiedApexValidationTableSchema } from '../schemas/simplified-apex.js';
 /* * */
 export class SimplifiedApexDatabase {
     //
-    //
-    // Tables
     bankingTaps;
     inspectionDecisions;
     inspections;
@@ -13,23 +11,31 @@ export class SimplifiedApexDatabase {
     refunds;
     sales;
     validations;
-    //
     databaseName = 'simplified_apex';
-    constructor(instance) {
+    constructor(client) {
         //
-        // Setup the table options, as they are the same for all simplified APEX tables
         const simplifiedTableOptions = {
             engine: 'ReplacingMergeTree(updated_at)',
             orderBy: ['agency_id', 'operational_date', 'created_at', '_id'],
             partitionBy: 'intDiv(operational_date, 100)',
         };
-        // Create the table interfaces
-        this.bankingTaps = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'banking_taps', simplifiedApexBankingTapSchema, simplifiedTableOptions);
-        this.inspectionDecisions = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'inspection_decisions', simplifiedApexInspectionDecisionSchema, simplifiedTableOptions);
-        this.inspections = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'inspections', simplifiedApexInspectionSchema, simplifiedTableOptions);
-        this.locations = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'locations', simplifiedApexLocationSchema, simplifiedTableOptions);
-        this.refunds = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'refunds', simplifiedApexOnBoardRefundSchema, simplifiedTableOptions);
-        this.sales = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'sales', simplifiedApexOnBoardSaleSchema, simplifiedTableOptions);
-        this.validations = new ClickHouseInterfaceTemplate(instance, this.databaseName, 'validations', simplifiedApexValidationSchema, simplifiedTableOptions);
+        this.bankingTaps = new ClickHouseInterfaceTemplate(client, this.databaseName, 'banking_taps', simplifiedApexBankingTapTableSchema, simplifiedTableOptions);
+        this.inspectionDecisions = new ClickHouseInterfaceTemplate(client, this.databaseName, 'inspection_decisions', simplifiedApexInspectionDecisionTableSchema, simplifiedTableOptions);
+        this.inspections = new ClickHouseInterfaceTemplate(client, this.databaseName, 'inspections', simplifiedApexInspectionTableSchema, simplifiedTableOptions);
+        this.locations = new ClickHouseInterfaceTemplate(client, this.databaseName, 'locations', simplifiedApexLocationTableSchema, simplifiedTableOptions);
+        this.refunds = new ClickHouseInterfaceTemplate(client, this.databaseName, 'refunds', simplifiedApexOnBoardRefundTableSchema, simplifiedTableOptions);
+        this.sales = new ClickHouseInterfaceTemplate(client, this.databaseName, 'sales', simplifiedApexOnBoardSaleTableSchema, simplifiedTableOptions);
+        this.validations = new ClickHouseInterfaceTemplate(client, this.databaseName, 'validations', simplifiedApexValidationTableSchema, simplifiedTableOptions);
+    }
+    async init() {
+        await Promise.all([
+            this.bankingTaps.init(),
+            this.inspectionDecisions.init(),
+            this.inspections.init(),
+            this.locations.init(),
+            this.refunds.init(),
+            this.sales.init(),
+            this.validations.init(),
+        ]);
     }
 }

package/dist/index.d.ts

@@ -1,20 +1,27 @@
-import { queryFromFile, queryFromString } from '@tmlmobilidade/go-clients-clickhouse';
+import { ClickHouseClient, queryFromFile, queryFromString } from '@tmlmobilidade/go-clients-clickhouse';
 import { OperationDatabase } from './databases/operation.js';
 import { PerformanceDatabase } from './databases/performance.js';
 import { SimplifiedApexDatabase } from './databases/simplified-apex.js';
 declare class LabDbClass {
     private static _instance;
-    private readonly clickhouseClient;
     readonly operation: OperationDatabase;
     readonly performance: PerformanceDatabase;
     readonly simplifiedApex: SimplifiedApexDatabase;
+    private readonly clickhouseClient;
+    private constructor();
     /**
-     * Establishes a connection to the Mongo database and initializes the collection.
-     * @param options Optional Mongo client connection options.
-     * @throws Error if the environment variable for the database URI is missing or if the connection fails.
+     * Returns the singleton instance.
+     * Concurrent callers share the same initialization promise so schema setup runs once.
      */
     static getInstance(): Promise<LabDbClass>;
-    private constructor();
+    /**
+     * Returns the ClickHouse client.
+     * @returns The ClickHouse client.
+     * @deprecated Avoid using this method directly. Find alternative ways
+     * to query the database using the database-specific methods instead.
+     */
+    getClient(): Promise<ClickHouseClient>;
+    private init;
     /**
      * Executes a query from a .sql file with optional parameter substitutions.
      * @param filePath Absolute or relative path to the .sql file.

package/dist/index.js

@@ -7,37 +7,50 @@ import { SimplifiedApexDatabase } from './databases/simplified-apex.js';
 /* * */
 class LabDbClass {
     //
-    //
-    //
-    static _instance;
-    clickhouseClient;
-    //
-    // Databases
+    static _instance = null;
     operation;
     performance;
     simplifiedApex;
+    clickhouseClient;
+    constructor(client) {
+        this.clickhouseClient = client;
+        this.operation = new OperationDatabase(this.clickhouseClient);
+        this.performance = new PerformanceDatabase(this.clickhouseClient);
+        this.simplifiedApex = new SimplifiedApexDatabase(this.clickhouseClient);
+    }
     /**
-     * Establishes a connection to the Mongo database and initializes the collection.
-     * @param options Optional Mongo client connection options.
-     * @throws Error if the environment variable for the database URI is missing or if the connection fails.
+     * Returns the singleton instance.
+     * Concurrent callers share the same initialization promise so schema setup runs once.
      */
     static async getInstance() {
         if (!LabDbClass._instance) {
-            const clickhouseClient = await ClickHouseDatabaseClient.getClient({ prefix: 'LABDB' });
-            LabDbClass._instance = new LabDbClass(clickhouseClient);
+            LabDbClass._instance = (async () => {
+                const clickhouseClient = await ClickHouseDatabaseClient.getClient({ prefix: 'LABDB', tunnelType: 'GO' });
+                const instance = new LabDbClass(clickhouseClient);
+                // Behaves like an async constructor: create DBs/tables before the proxy exposes the instance.
+                await instance.init();
+                return instance;
+            })();
         }
-        return LabDbClass._instance;
+        return await LabDbClass._instance;
     }
-    //
-    // Constructor
-    constructor(clickhouseClient) {
-        this.clickhouseClient = clickhouseClient;
-        this.operation = new OperationDatabase(this.clickhouseClient);
-        this.performance = new PerformanceDatabase(this.clickhouseClient);
-        this.simplifiedApex = new SimplifiedApexDatabase(this.clickhouseClient);
+    /**
+     * Returns the ClickHouse client.
+     * @returns The ClickHouse client.
+     * @deprecated Avoid using this method directly. Find alternative ways
+     * to query the database using the database-specific methods instead.
+     */
+    async getClient() {
+        const instance = await LabDbClass.getInstance();
+        return instance.clickhouseClient;
+    }
+    async init() {
+        await Promise.all([
+            this.operation.init(),
+            this.performance.init(),
+            this.simplifiedApex.init(),
+        ]);
     }
-    //
-    // Queries
     /**
      * Executes a query from a .sql file with optional parameter substitutions.
      * @param filePath Absolute or relative path to the .sql file.
@@ -70,4 +83,5 @@ class LabDbClass {
         return await queryFromString(this.clickhouseClient, query, params);
     }
 }
+/* * */
 export const labDb = asyncSingletonProxy(LabDbClass);

package/dist/interface.template.d.ts

@@ -1,4 +1,4 @@
-import type { ClickHouseClient, ClickhouseField, ClickHouseTableEngine, ClickHouseTableSchema, DataFormat } from '@tmlmobilidade/go-clients-clickhouse';
+import { type ClickHouseClient, type ClickhouseField, type ClickHouseTableEngine, type ClickHouseTableSchema, type DataFormat } from '@tmlmobilidade/go-clients-clickhouse';
 import { queryFromFile, queryFromString } from '@tmlmobilidade/go-clients-clickhouse';
 export interface ClickhouseInterfaceTableOptions<T extends object> {
     engine?: ClickHouseTableEngine<T>;
@@ -74,13 +74,12 @@ export declare class ClickHouseInterfaceTemplate<T extends object> {
      */
     select(select: string, where: string, params?: Record<string, number | string>): Promise<T[]>;
     /**
-     * Initializes the ClickHouse client and ensures that the specified database and table exist.
-     * This method should be called before performing any operations on the database or table.
-     * It handles the asynchronous setup process and logs any errors that occur during initialization.
-     * @throws Will throw an error if the client initialization or database/table setup fails.
+     * Ensures that the specified database and table exist.
+     * Called by `LabDbClass.getInstance()` before the singleton is exposed via `asyncSingletonProxy`.
+     * @throws Will throw an error if database/table setup fails.
      * @returns A promise that resolves when the initialization process is complete.
      */
-    protected init(): Promise<void>;
+    init(): Promise<void>;
     /**
      * Optional override for custom setup logic:
      * indexes, materialized views, constraints, etc.
@@ -113,6 +112,13 @@ export declare class ClickHouseInterfaceTemplate<T extends object> {
      * );
     */
     queryFromString<T>(query: string, params?: Record<string, number | string>): ReturnType<typeof queryFromString<T>>;
+    /**
+     * Ensures that the specified database exists in ClickHouse, creating it if it does not already exist.
+     * This method performs input validation to prevent SQL injection and logs the outcome of the operation.
+     * It constructs a CREATE DATABASE query and executes it using the client.
+     * @throws Will throw an error if any of the inputs are unsafe or if the database creation query fails.
+     * @returns A promise that resolves when the database is ensured to exist.
+     */
     private ensureDatabase;
     /**
      * Ensures that the specified table exists in ClickHouse, creating it if it does not already exist.

package/dist/interface.template.js

@@ -26,10 +26,6 @@ export class ClickHouseInterfaceTemplate {
             partitionBy: options.partitionBy ?? undefined,
             primaryKey: options.primaryKey ?? undefined,
         };
-        this.init().catch((error) => {
-            Logger.error({ error, message: `LABDB [${this.databaseName}."${this.tableName}"]: Error @ constructor(): ${error.message}` });
-            throw error;
-        });
     }
     /**
      * Executes a COUNT query on the ClickHouse table using the service's client.
@@ -73,8 +69,6 @@ export class ClickHouseInterfaceTemplate {
      * @warning Use with caution: direct access to the client allows for executing arbitrary queries.
      */
     async getClient() {
-        if (!this.client)
-            await this.init();
         return this.client;
     }
     /**
@@ -113,16 +107,12 @@ export class ClickHouseInterfaceTemplate {
         return await queryFromString(this.client, `SELECT ${select} FROM "${this.databaseName}"."${this.tableName}" WHERE ${where}`, params);
     }
     /**
-     * Initializes the ClickHouse client and ensures that the specified database and table exist.
-     * This method should be called before performing any operations on the database or table.
-     * It handles the asynchronous setup process and logs any errors that occur during initialization.
-     * @throws Will throw an error if the client initialization or database/table setup fails.
+     * Ensures that the specified database and table exist.
+     * Called by `LabDbClass.getInstance()` before the singleton is exposed via `asyncSingletonProxy`.
+     * @throws Will throw an error if database/table setup fails.
      * @returns A promise that resolves when the initialization process is complete.
      */
     async init() {
-        // Skip if already initialized
-        if (this.client)
-            return;
         // Validate required properties before attempting to connect
         if (!this.databaseName)
             throw new Error('CLICKHOUSE: databaseName is required.');
@@ -134,9 +124,9 @@ export class ClickHouseInterfaceTemplate {
         // Only own the schema when this interface is the source of truth.
         // External DDL owners (see `manageSchema`) skip this entirely.
         if (this.tableOptions.manageSchema) {
-            await this.ensureDatabase();
             await this.ensureTable();
         }
+        // Run any additional setup logic
         await this.postInit();
     }
     /**
@@ -177,6 +167,13 @@ export class ClickHouseInterfaceTemplate {
     async queryFromString(query, params) {
         return await queryFromString(this.client, query, params);
     }
+    /**
+     * Ensures that the specified database exists in ClickHouse, creating it if it does not already exist.
+     * This method performs input validation to prevent SQL injection and logs the outcome of the operation.
+     * It constructs a CREATE DATABASE query and executes it using the client.
+     * @throws Will throw an error if any of the inputs are unsafe or if the database creation query fails.
+     * @returns A promise that resolves when the database is ensured to exist.
+     */
     async ensureDatabase() {
         // Validate the inputs are safe identifiers to prevent SQL injection
         if (!validateSqlParam(this.databaseName, false))
@@ -213,7 +210,9 @@ export class ClickHouseInterfaceTemplate {
         // Setup the full CREATE TABLE query
         const createTableQuery = `
 			CREATE TABLE IF NOT EXISTS "${this.databaseName}"."${this.tableName}" (
-				${Object.entries(this.schema).map(([key, column]) => `${key} ${column.type}`).join(', ')}
+				${Object.entries(this.schema)
+            .map(([key, column]) => `${key} ${column.type} ${column.materialized ? ` MATERIALIZED ${column.materialized}` : ''}`)
+            .join(', ')}
 			) ENGINE = ${this.tableOptions.engine}
 			${this.tableOptions.primaryKey ? `PRIMARY KEY (${Array.isArray(this.tableOptions.primaryKey) ? this.tableOptions.primaryKey.join(', ') : this.tableOptions.primaryKey})` : ''}
 			${this.tableOptions.orderBy ? `ORDER BY (${Array.isArray(this.tableOptions.orderBy) ? this.tableOptions.orderBy.join(', ') : this.tableOptions.orderBy})` : ''}
@@ -243,7 +242,6 @@ export class ClickHouseInterfaceTemplate {
                 throw error;
             }
             catch (verifyError) {
-                //
                 Logger.error({ error: verifyError, message: `LABDB [${this.tableName}]: Failed to verify table existence after ACCESS_DENIED: ${verifyError.message}` });
                 throw verifyError;
             }

package/dist/schemas/operation.d.ts

@@ -0,0 +1,3 @@
+import { type ClickHouseTableSchema } from '@tmlmobilidade/go-clients-clickhouse';
+import { type SimplifiedVehicleEvent } from '@tmlmobilidade/go-types-vehicle-events';
+export declare const simplifiedVehicleEventTableSchema: ClickHouseTableSchema<SimplifiedVehicleEvent>;

package/dist/schemas/operation.js

@@ -0,0 +1,21 @@
+/* * */
+/* * */
+export const simplifiedVehicleEventTableSchema = {
+    _id: { type: 'String' },
+    agency_id: { type: 'LowCardinality(String)' },
+    bearing: { type: 'Nullable(UInt16) CODEC(T64, ZSTD)' },
+    created_at: { type: 'Int64 CODEC(DoubleDelta, ZSTD)' },
+    current_status: { type: 'LowCardinality(Nullable(String))' },
+    driver_id: { type: 'LowCardinality(Nullable(String))' },
+    extra_trip_id: { type: 'Nullable(String)' },
+    geohash: { materialized: 'geohashEncode(longitude, latitude, 7)', type: 'FixedString(7)' },
+    latitude: { type: 'Float32 CODEC(Gorilla, ZSTD)' },
+    longitude: { type: 'Float32 CODEC(Gorilla, ZSTD)' },
+    odometer: { type: 'Nullable(UInt32)' },
+    operational_date: { type: 'UInt32' },
+    received_at: { type: 'Int64 CODEC(DoubleDelta, ZSTD)' },
+    speed: { type: 'Nullable(UInt8) CODEC(T64, ZSTD)' },
+    stop_id: { type: 'LowCardinality(Nullable(String))' },
+    trip_id: { type: 'String' },
+    vehicle_id: { type: 'LowCardinality(String)' },
+};

package/dist/{types → schemas}/performance.d.ts

@@ -1,3 +1,3 @@
 import { type ClickHouseTableSchema } from '@tmlmobilidade/go-clients-clickhouse';
 import { type DemandByAgencyByOperationalDate } from '@tmlmobilidade/go-types-performance';
-export declare const demandByAgencyByOperationalDateSchema: ClickHouseTableSchema<DemandByAgencyByOperationalDate>;
+export declare const demandByAgencyByOperationalDateTableSchema: ClickHouseTableSchema<DemandByAgencyByOperationalDate>;

package/dist/{types → schemas}/performance.js

@@ -1,6 +1,6 @@
 /* * */
 /* * */
-export const demandByAgencyByOperationalDateSchema = {
+export const demandByAgencyByOperationalDateTableSchema = {
     agency_id: { type: 'LowCardinality(String)' },
     operational_date: { type: 'UInt32' },
     qty: { type: 'UInt64' },

package/dist/schemas/simplified-apex.d.ts

@@ -0,0 +1,9 @@
+import { type ClickHouseTableSchema } from '@tmlmobilidade/go-clients-clickhouse';
+import { type SimplifiedApexBankingTap, SimplifiedApexInspection, SimplifiedApexInspectionDecision, SimplifiedApexLocation, SimplifiedApexOnBoardRefund, SimplifiedApexOnBoardSale, SimplifiedApexValidation } from '@tmlmobilidade/go-types-apex';
+export declare const simplifiedApexBankingTapTableSchema: ClickHouseTableSchema<SimplifiedApexBankingTap>;
+export declare const simplifiedApexInspectionDecisionTableSchema: ClickHouseTableSchema<SimplifiedApexInspectionDecision>;
+export declare const simplifiedApexInspectionTableSchema: ClickHouseTableSchema<SimplifiedApexInspection>;
+export declare const simplifiedApexLocationTableSchema: ClickHouseTableSchema<SimplifiedApexLocation>;
+export declare const simplifiedApexOnBoardRefundTableSchema: ClickHouseTableSchema<SimplifiedApexOnBoardRefund>;
+export declare const simplifiedApexOnBoardSaleTableSchema: ClickHouseTableSchema<SimplifiedApexOnBoardSale>;
+export declare const simplifiedApexValidationTableSchema: ClickHouseTableSchema<SimplifiedApexValidation>;

package/dist/{types → schemas}/simplified-apex.js

@@ -1,6 +1,6 @@
 /* * */
 /* * */
-export const simplifiedApexBankingTapSchema = {
+export const simplifiedApexBankingTapTableSchema = {
     _id: { type: 'UUID' },
     agency_id: { type: 'LowCardinality(String)' },
     apex_version: { type: 'LowCardinality(String)' },
@@ -25,7 +25,7 @@ export const simplifiedApexBankingTapSchema = {
     updated_at: { type: 'Int64' },
     vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
-export const simplifiedApexInspectionDecisionSchema = {
+export const simplifiedApexInspectionDecisionTableSchema = {
     _id: { type: 'UUID' },
     agency_id: { type: 'LowCardinality(String)' },
     apex_version: { type: 'LowCardinality(String)' },
@@ -41,7 +41,7 @@ export const simplifiedApexInspectionDecisionSchema = {
     received_at: { type: 'Int64' },
     updated_at: { type: 'Int64' },
 };
-export const simplifiedApexInspectionSchema = {
+export const simplifiedApexInspectionTableSchema = {
     _id: { type: 'UUID' },
     agency_id: { type: 'LowCardinality(String)' },
     apex_version: { type: 'LowCardinality(String)' },
@@ -66,7 +66,7 @@ export const simplifiedApexInspectionSchema = {
     updated_at: { type: 'Int64' },
     vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
-export const simplifiedApexLocationSchema = {
+export const simplifiedApexLocationTableSchema = {
     _id: { type: 'UUID' },
     agency_id: { type: 'LowCardinality(String)' },
     apex_version: { type: 'LowCardinality(String)' },
@@ -85,7 +85,7 @@ export const simplifiedApexLocationSchema = {
     updated_at: { type: 'Int64' },
     vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
-export const simplifiedApexOnBoardRefundSchema = {
+export const simplifiedApexOnBoardRefundTableSchema = {
     _id: { type: 'UUID' },
     agency_id: { type: 'LowCardinality(String)' },
     apex_version: { type: 'LowCardinality(String)' },
@@ -112,7 +112,7 @@ export const simplifiedApexOnBoardRefundSchema = {
     validation_id: { type: 'Nullable(UUID)' },
     vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
-export const simplifiedApexOnBoardSaleSchema = {
+export const simplifiedApexOnBoardSaleTableSchema = {
     _id: { type: 'UUID' },
     agency_id: { type: 'LowCardinality(String)' },
     apex_version: { type: 'LowCardinality(String)' },
@@ -140,7 +140,7 @@ export const simplifiedApexOnBoardSaleSchema = {
     validation_id: { type: 'Nullable(UUID)' },
     vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
-export const simplifiedApexValidationSchema = {
+export const simplifiedApexValidationTableSchema = {
     _id: { type: 'UUID' },
     agency_id: { type: 'LowCardinality(String)' },
     apex_version: { type: 'LowCardinality(String)' },

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/go-interfaces-labdb",
-	"version": "20260722.1043.2",
+	"version": "20260723.1350.16",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"
@@ -39,15 +39,13 @@
 		"@tmlmobilidade/go-clients-clickhouse": "*",
 		"@tmlmobilidade/go-types-apex": "*",
 		"@tmlmobilidade/go-types-performance": "*",
+		"@tmlmobilidade/go-types-vehicle-events": "*",
 		"@tmlmobilidade/logger": "*",
 		"@tmlmobilidade/types": "*",
-		"@tmlmobilidade/utils": "*",
-		"luxon": "3.7.2",
-		"zod": "3.25.76"
+		"@tmlmobilidade/utils": "*"
 	},
 	"devDependencies": {
 		"@tmlmobilidade/tsconfig": "*",
-		"@types/luxon": "3.7.2",
 		"@types/node": "26.1.1",
 		"resolve-tspaths": "0.8.23",
 		"tsc-watch": "7.2.1",

package/dist/types/operation.d.ts

@@ -1,3 +0,0 @@
-import { type ClickHouseTableSchema } from '@tmlmobilidade/go-clients-clickhouse';
-import { type SimplifiedVehicleEvent } from '@tmlmobilidade/types';
-export declare const simplifiedVehicleEventSchema: ClickHouseTableSchema<SimplifiedVehicleEvent>;

package/dist/types/operation.js

@@ -1,24 +0,0 @@
-/* * */
-/* * */
-export const simplifiedVehicleEventSchema = {
-    _id: { type: 'String' },
-    agency_id: { type: 'String' },
-    created_at: { type: 'Int64' },
-    geohash: { default: 'geohashEncode(longitude, latitude, 7)', type: 'String' },
-    latitude: { type: 'Float64' },
-    longitude: { type: 'Float64' },
-    operational_date: { type: 'Date' },
-    received_at: { type: 'Int64' },
-    trip_id: { type: 'String' },
-    vehicle_id: { type: 'String' },
-    // Optional Fields
-    bearing: { type: 'Nullable(Int64)' },
-    current_status: { type: 'Nullable(String)' },
-    door: { type: 'Nullable(String)' },
-    driver_id: { type: 'Nullable(String)' },
-    extra_trip_id: { type: 'Nullable(String)' },
-    odometer: { type: 'Nullable(Int64)' },
-    pattern_id: { type: 'Nullable(String)' },
-    speed: { type: 'Nullable(Int64)' },
-    stop_id: { type: 'Nullable(String)' },
-};

package/dist/types/simplified-apex.d.ts

@@ -1,9 +0,0 @@
-import { type ClickHouseTableSchema } from '@tmlmobilidade/go-clients-clickhouse';
-import { type SimplifiedApexBankingTap, SimplifiedApexInspection, SimplifiedApexInspectionDecision, SimplifiedApexLocation, SimplifiedApexOnBoardRefund, SimplifiedApexOnBoardSale, SimplifiedApexValidation } from '@tmlmobilidade/go-types-apex';
-export declare const simplifiedApexBankingTapSchema: ClickHouseTableSchema<SimplifiedApexBankingTap>;
-export declare const simplifiedApexInspectionDecisionSchema: ClickHouseTableSchema<SimplifiedApexInspectionDecision>;
-export declare const simplifiedApexInspectionSchema: ClickHouseTableSchema<SimplifiedApexInspection>;
-export declare const simplifiedApexLocationSchema: ClickHouseTableSchema<SimplifiedApexLocation>;
-export declare const simplifiedApexOnBoardRefundSchema: ClickHouseTableSchema<SimplifiedApexOnBoardRefund>;
-export declare const simplifiedApexOnBoardSaleSchema: ClickHouseTableSchema<SimplifiedApexOnBoardSale>;
-export declare const simplifiedApexValidationSchema: ClickHouseTableSchema<SimplifiedApexValidation>;