@tmlmobilidade/databases 20260616.1147.27 → 20260616.2238.2

package/dist/interfaces/apex/simplified/simplified-apex-banking-taps.d.ts

@@ -1,10 +1,13 @@
 import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
-import { type ClickHouseSchema } from '../../../types/index.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../../../types/index.js';
 import { type SimplifiedApexBankingTap } from '@tmlmobilidade/go-types-apex';
 declare class SimplifiedApexBankingTapsNewClass extends ClickHouseInterfaceTemplate<SimplifiedApexBankingTap> {
     private static _instance;
     protected readonly databaseName = "simplified_apex";
-    protected readonly schema: ClickHouseSchema<{
+    protected readonly engine: ClickHouseTableEngine<SimplifiedApexBankingTap>;
+    protected readonly orderBy = "agency_id, created_at, _id";
+    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly schema: ClickHouseTableSchema<{
         _id: string;
         agency_id: string;
         created_at: number & {
@@ -16,6 +19,9 @@ declare class SimplifiedApexBankingTapsNewClass extends ClickHouseInterfaceTempl
         };
         apex_version: string;
         banking_token: string;
+        calendar_date: string & {
+            __brand: "CalendarDate";
+        };
         card_brand: number;
         card_pan: string;
         device_id: string;
@@ -29,7 +35,10 @@ declare class SimplifiedApexBankingTapsNewClass extends ClickHouseInterfaceTempl
         stop_id: string;
         trip_id: string;
         units_qty: number;
-        vehicle_id: number;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
+        vehicle_id: number | null;
     }>;
     protected readonly tableName = "banking_taps";
     /**

package/dist/interfaces/apex/simplified/simplified-apex-banking-taps.js

@@ -4,33 +4,38 @@ import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
 import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */
 const tableSchema = {
-    _id: { primaryKey: true, type: 'String' },
-    agency_id: { type: 'String' },
-    apex_version: { type: 'String' },
+    _id: { type: 'UUID' },
+    agency_id: { type: 'LowCardinality(String)' },
+    apex_version: { type: 'LowCardinality(String)' },
     banking_token: { type: 'String' },
-    card_brand: { type: 'Int64' },
+    calendar_date: { type: 'Date' },
+    card_brand: { type: 'UInt8' },
     card_pan: { type: 'String' },
-    created_at: { type: 'Int64' },
-    device_id: { type: 'String' },
-    event_type: { type: 'Int64' },
+    created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    device_id: { type: 'LowCardinality(String)' },
+    event_type: { type: 'UInt8' },
     is_ok: { type: 'Bool' },
     is_ok_pcgi: { type: 'Bool' },
-    line_id: { type: 'String' },
-    mac_ase_counter_value: { type: 'Int64' },
-    mac_sam_serial_number: { type: 'Int64' },
-    pattern_id: { type: 'String' },
-    product_id: { type: 'String' },
-    received_at: { type: 'Int64' },
-    stop_id: { type: 'String' },
-    trip_id: { type: 'String' },
-    units_qty: { type: 'Int64' },
-    vehicle_id: { type: 'String' },
+    line_id: { type: 'LowCardinality(String)' },
+    mac_ase_counter_value: { type: 'UInt64' },
+    mac_sam_serial_number: { type: 'UInt64' },
+    pattern_id: { type: 'LowCardinality(String)' },
+    product_id: { type: 'LowCardinality(String)' },
+    received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    stop_id: { type: 'LowCardinality(String)' },
+    trip_id: { type: 'Nullable(String)' },
+    units_qty: { type: 'Nullable(Int32)' },
+    updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    vehicle_id: { type: 'LowCardinality(String)' },
 };
 /* * */
 class SimplifiedApexBankingTapsNewClass extends ClickHouseInterfaceTemplate {
     //
     static _instance = null;
     databaseName = 'simplified_apex';
+    engine = 'ReplacingMergeTree(updated_at)';
+    orderBy = 'agency_id, created_at, _id';
+    partitionBy = 'toYYYYMM(created_at)';
     schema = tableSchema;
     tableName = 'banking_taps';
     /**

package/dist/interfaces/apex/simplified/simplified-apex-inspection-decisions.d.ts

@@ -1,10 +1,13 @@
 import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
-import { type ClickHouseSchema } from '../../../types/index.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../../../types/index.js';
 import { type SimplifiedApexInspectionDecision } from '@tmlmobilidade/go-types-apex';
 declare class SimplifiedApexInspectionDecisionsNewClass extends ClickHouseInterfaceTemplate<SimplifiedApexInspectionDecision> {
     private static _instance;
     protected readonly databaseName = "simplified_apex";
-    protected readonly schema: ClickHouseSchema<{
+    protected readonly engine: ClickHouseTableEngine<SimplifiedApexInspectionDecision>;
+    protected readonly orderBy = "agency_id, created_at, _id";
+    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly schema: ClickHouseTableSchema<{
         _id: string;
         agency_id: string;
         created_at: number & {
@@ -15,10 +18,16 @@ declare class SimplifiedApexInspectionDecisionsNewClass extends ClickHouseInterf
             __brand: "UnixTimestamp";
         };
         apex_version: string;
+        calendar_date: string & {
+            __brand: "CalendarDate";
+        };
         device_id: string;
         is_ok_pcgi: boolean;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
         final_control_status: number;
         inspection_decision_id: string | null;
     }>;

package/dist/interfaces/apex/simplified/simplified-apex-inspection-decisions.js

@@ -4,24 +4,29 @@ import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
 import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */
 const tableSchema = {
-    _id: { primaryKey: true, type: 'String' },
-    agency_id: { type: 'String' },
-    apex_version: { type: 'String' },
-    created_at: { type: 'Int64' },
-    device_id: { type: 'String' },
-    final_control_status: { type: 'Int64' },
-    inspection_decision_id: { type: 'String' },
+    _id: { type: 'UUID' },
+    agency_id: { type: 'LowCardinality(String)' },
+    apex_version: { type: 'LowCardinality(String)' },
+    calendar_date: { type: 'Date' },
+    created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    device_id: { type: 'LowCardinality(String)' },
+    final_control_status: { type: 'UInt8' },
+    inspection_decision_id: { type: 'Nullable(UUID)' },
     is_ok: { type: 'Bool' },
     is_ok_pcgi: { type: 'Bool' },
-    mac_ase_counter_value: { type: 'Int64' },
-    mac_sam_serial_number: { type: 'Int64' },
-    received_at: { type: 'Int64' },
+    mac_ase_counter_value: { type: 'UInt64' },
+    mac_sam_serial_number: { type: 'UInt64' },
+    received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
 };
 /* * */
 class SimplifiedApexInspectionDecisionsNewClass extends ClickHouseInterfaceTemplate {
     //
     static _instance = null;
     databaseName = 'simplified_apex';
+    engine = 'ReplacingMergeTree(updated_at)';
+    orderBy = 'agency_id, created_at, _id';
+    partitionBy = 'toYYYYMM(created_at)';
     schema = tableSchema;
     tableName = 'inspection_decisions';
     /**

package/dist/interfaces/apex/simplified/simplified-apex-inspections.d.ts

@@ -1,10 +1,13 @@
 import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
-import { type ClickHouseSchema } from '../../../types/index.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../../../types/index.js';
 import { type SimplifiedApexInspection } from '@tmlmobilidade/go-types-apex';
 declare class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTemplate<SimplifiedApexInspection> {
     private static _instance;
     protected readonly databaseName = "simplified_apex";
-    protected readonly schema: ClickHouseSchema<{
+    protected readonly engine: ClickHouseTableEngine<SimplifiedApexInspection>;
+    protected readonly orderBy = "agency_id, created_at, _id";
+    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly schema: ClickHouseTableSchema<{
         _id: string;
         agency_id: string;
         created_at: number & {
@@ -15,6 +18,9 @@ declare class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTempl
             __brand: "UnixTimestamp";
         };
         apex_version: string;
+        calendar_date: string & {
+            __brand: "CalendarDate";
+        };
         device_id: string;
         is_ok_pcgi: boolean;
         line_id: string;
@@ -23,8 +29,11 @@ declare class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTempl
         pattern_id: string;
         product_id: string | null;
         trip_id: string | null;
-        vehicle_id: number;
-        card_serial_number: string;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
+        vehicle_id: number | null;
+        card_serial_number: bigint | null;
         control_destination_stop_id: string;
         control_origin_stop_id: string;
         control_status: number;

package/dist/interfaces/apex/simplified/simplified-apex-inspections.js

@@ -4,33 +4,38 @@ import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
 import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */
 const tableSchema = {
-    _id: { primaryKey: true, type: 'String' },
-    agency_id: { type: 'String' },
-    apex_version: { type: 'String' },
-    card_serial_number: { type: 'String' },
-    control_destination_stop_id: { type: 'String' },
-    control_origin_stop_id: { type: 'String' },
-    control_status: { type: 'Int64' },
-    created_at: { type: 'Int64' },
-    device_id: { type: 'String' },
-    environment_status: { type: 'Int64' },
-    inspection_id: { type: 'String' },
+    _id: { type: 'UUID' },
+    agency_id: { type: 'LowCardinality(String)' },
+    apex_version: { type: 'LowCardinality(String)' },
+    calendar_date: { type: 'Date' },
+    card_serial_number: { type: 'Nullable(UInt64)' },
+    control_destination_stop_id: { type: 'Nullable(LowCardinality(String))' },
+    control_origin_stop_id: { type: 'Nullable(LowCardinality(String))' },
+    control_status: { type: 'UInt8' },
+    created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    device_id: { type: 'LowCardinality(String)' },
+    environment_status: { type: 'UInt8' },
+    inspection_id: { type: 'Nullable(UUID)' },
     is_ok: { type: 'Bool' },
     is_ok_pcgi: { type: 'Bool' },
-    line_id: { type: 'String' },
-    mac_ase_counter_value: { type: 'Int64' },
-    mac_sam_serial_number: { type: 'Int64' },
-    pattern_id: { type: 'String' },
-    product_id: { type: 'String' },
-    received_at: { type: 'Int64' },
-    trip_id: { type: 'String' },
-    vehicle_id: { type: 'String' },
+    line_id: { type: 'Nullable(LowCardinality(String))' },
+    mac_ase_counter_value: { type: 'UInt64' },
+    mac_sam_serial_number: { type: 'UInt64' },
+    pattern_id: { type: 'Nullable(LowCardinality(String))' },
+    product_id: { type: 'Nullable(LowCardinality(String))' },
+    received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    trip_id: { type: 'Nullable(String)' },
+    updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    vehicle_id: { type: 'Nullable(LowCardinality(String))' },
 };
 /* * */
 class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTemplate {
     //
     static _instance = null;
     databaseName = 'simplified_apex';
+    engine = 'ReplacingMergeTree(updated_at)';
+    orderBy = 'agency_id, created_at, _id';
+    partitionBy = 'toYYYYMM(created_at)';
     schema = tableSchema;
     tableName = 'inspections';
     /**

package/dist/interfaces/apex/simplified/simplified-apex-locations.d.ts

@@ -1,10 +1,13 @@
 import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
-import { type ClickHouseSchema } from '../../../types/index.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../../../types/index.js';
 import { type SimplifiedApexLocation } from '@tmlmobilidade/go-types-apex';
 declare class SimplifiedApexLocationsNewClass extends ClickHouseInterfaceTemplate<SimplifiedApexLocation> {
     private static _instance;
     protected readonly databaseName = "simplified_apex";
-    protected readonly schema: ClickHouseSchema<{
+    protected readonly engine: ClickHouseTableEngine<SimplifiedApexLocation>;
+    protected readonly orderBy = "agency_id, created_at, _id";
+    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly schema: ClickHouseTableSchema<{
         _id: string;
         agency_id: string;
         created_at: number & {
@@ -14,6 +17,9 @@ declare class SimplifiedApexLocationsNewClass extends ClickHouseInterfaceTemplat
             __brand: "UnixTimestamp";
         };
         apex_version: string;
+        calendar_date: string & {
+            __brand: "CalendarDate";
+        };
         device_id: string;
         line_id: string;
         mac_ase_counter_value: number;
@@ -21,7 +27,10 @@ declare class SimplifiedApexLocationsNewClass extends ClickHouseInterfaceTemplat
         pattern_id: string;
         stop_id: string;
         trip_id: string | null;
-        vehicle_id: number;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
+        vehicle_id: number | null;
     }>;
     protected readonly tableName = "locations";
     /**

package/dist/interfaces/apex/simplified/simplified-apex-locations.js

@@ -4,25 +4,30 @@ import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
 import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */
 const tableSchema = {
-    _id: { primaryKey: true, type: 'String' },
-    agency_id: { type: 'String' },
-    apex_version: { type: 'String' },
-    created_at: { type: 'Int64' },
-    device_id: { type: 'String' },
-    line_id: { type: 'String' },
-    mac_ase_counter_value: { type: 'Int64' },
-    mac_sam_serial_number: { type: 'Int64' },
-    pattern_id: { type: 'String' },
-    received_at: { type: 'Int64' },
-    stop_id: { type: 'String' },
-    trip_id: { type: 'String' },
-    vehicle_id: { type: 'String' },
+    _id: { type: 'UUID' },
+    agency_id: { type: 'LowCardinality(String)' },
+    apex_version: { type: 'LowCardinality(String)' },
+    calendar_date: { type: 'Date' },
+    created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    device_id: { type: 'LowCardinality(String)' },
+    line_id: { type: 'Nullable(LowCardinality(String))' },
+    mac_ase_counter_value: { type: 'UInt64' },
+    mac_sam_serial_number: { type: 'UInt64' },
+    pattern_id: { type: 'Nullable(LowCardinality(String))' },
+    received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    stop_id: { type: 'Nullable(LowCardinality(String))' },
+    trip_id: { type: 'Nullable(String)' },
+    updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    vehicle_id: { type: 'Nullable(LowCardinality(String))' },
 };
 /* * */
 class SimplifiedApexLocationsNewClass extends ClickHouseInterfaceTemplate {
     //
     static _instance = null;
     databaseName = 'simplified_apex';
+    engine = 'ReplacingMergeTree(updated_at)';
+    orderBy = 'agency_id, created_at, _id';
+    partitionBy = 'toYYYYMM(created_at)';
     schema = tableSchema;
     tableName = 'locations';
     /**

package/dist/interfaces/apex/simplified/simplified-apex-refunds.d.ts

@@ -1,10 +1,13 @@
 import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
-import { type ClickHouseSchema } from '../../../types/index.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../../../types/index.js';
 import { type SimplifiedApexOnBoardRefund } from '@tmlmobilidade/go-types-apex';
 declare class SimplifiedApexOnBoardRefundsNewClass extends ClickHouseInterfaceTemplate<SimplifiedApexOnBoardRefund> {
     private static _instance;
     protected readonly databaseName = "simplified_apex";
-    protected readonly schema: ClickHouseSchema<{
+    protected readonly engine: ClickHouseTableEngine<SimplifiedApexOnBoardRefund>;
+    protected readonly orderBy = "agency_id, created_at, _id";
+    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly schema: ClickHouseTableSchema<{
         _id: string;
         agency_id: string;
         created_at: number & {
@@ -15,6 +18,9 @@ declare class SimplifiedApexOnBoardRefundsNewClass extends ClickHouseInterfaceTe
         };
         price: number;
         apex_version: string;
+        calendar_date: string & {
+            __brand: "CalendarDate";
+        };
         device_id: string;
         line_id: string | null;
         mac_ase_counter_value: number;
@@ -22,8 +28,11 @@ declare class SimplifiedApexOnBoardRefundsNewClass extends ClickHouseInterfaceTe
         pattern_id: string | null;
         stop_id: string | null;
         trip_id: string | null;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
         vehicle_id: number | null;
-        card_serial_number: string;
+        card_serial_number: bigint | null;
         block_id: string | null;
         card_physical_type: number;
         duty_id: string | null;

package/dist/interfaces/apex/simplified/simplified-apex-refunds.js

@@ -4,35 +4,40 @@ import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
 import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */
 const tableSchema = {
-    _id: { primaryKey: true, type: 'String' },
-    agency_id: { type: 'String' },
-    apex_version: { type: 'String' },
-    block_id: { type: 'String' },
-    card_physical_type: { type: 'String' },
-    card_serial_number: { type: 'String' },
-    created_at: { type: 'Int64' },
-    device_id: { type: 'String' },
-    duty_id: { type: 'String' },
-    line_id: { type: 'String' },
-    mac_ase_counter_value: { type: 'Int64' },
-    mac_sam_serial_number: { type: 'Int64' },
-    on_board_sale_id: { type: 'Nullable(String)' },
-    pattern_id: { type: 'String' },
-    payment_method: { type: 'String' },
-    price: { type: 'Int64' },
-    product_long_id: { type: 'String' },
-    product_quantity: { type: 'Int64' },
-    received_at: { type: 'Int64' },
-    stop_id: { type: 'String' },
-    trip_id: { type: 'String' },
-    validation_id: { type: 'Nullable(String)' },
-    vehicle_id: { type: 'String' },
+    _id: { type: 'UUID' },
+    agency_id: { type: 'LowCardinality(String)' },
+    apex_version: { type: 'LowCardinality(String)' },
+    block_id: { type: 'Nullable(String)' },
+    calendar_date: { type: 'Date' },
+    card_physical_type: { type: 'UInt8' },
+    card_serial_number: { type: 'Nullable(UInt64)' },
+    created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    device_id: { type: 'LowCardinality(String)' },
+    duty_id: { type: 'Nullable(String)' },
+    line_id: { type: 'Nullable(LowCardinality(String))' },
+    mac_ase_counter_value: { type: 'UInt64' },
+    mac_sam_serial_number: { type: 'UInt64' },
+    on_board_sale_id: { type: 'Nullable(UUID)' },
+    pattern_id: { type: 'Nullable(LowCardinality(String))' },
+    payment_method: { type: 'UInt8' },
+    price: { type: 'Int32' },
+    product_long_id: { type: 'Nullable(LowCardinality(String))' },
+    product_quantity: { type: 'Int32' },
+    received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    stop_id: { type: 'Nullable(LowCardinality(String))' },
+    trip_id: { type: 'Nullable(String)' },
+    updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    validation_id: { type: 'Nullable(UUID)' },
+    vehicle_id: { type: 'Nullable(LowCardinality(String))' },
 };
 /* * */
 class SimplifiedApexOnBoardRefundsNewClass extends ClickHouseInterfaceTemplate {
     //
     static _instance = null;
     databaseName = 'simplified_apex';
+    engine = 'ReplacingMergeTree(updated_at)';
+    orderBy = 'agency_id, created_at, _id';
+    partitionBy = 'toYYYYMM(created_at)';
     schema = tableSchema;
     tableName = 'refunds';
     /**

package/dist/interfaces/apex/simplified/simplified-apex-sales.d.ts

@@ -1,10 +1,13 @@
 import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
-import { type ClickHouseSchema } from '../../../types/index.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../../../types/index.js';
 import { type SimplifiedApexOnBoardSale } from '@tmlmobilidade/go-types-apex';
 declare class SimplifiedApexOnBoardSalesNewClass extends ClickHouseInterfaceTemplate<SimplifiedApexOnBoardSale> {
     private static _instance;
     protected readonly databaseName = "simplified_apex";
-    protected readonly schema: ClickHouseSchema<{
+    protected readonly engine: ClickHouseTableEngine<SimplifiedApexOnBoardSale>;
+    protected readonly orderBy = "agency_id, created_at, _id";
+    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly schema: ClickHouseTableSchema<{
         _id: string;
         agency_id: string;
         created_at: number & {
@@ -15,6 +18,9 @@ declare class SimplifiedApexOnBoardSalesNewClass extends ClickHouseInterfaceTemp
         };
         price: number;
         apex_version: string;
+        calendar_date: string & {
+            __brand: "CalendarDate";
+        };
         device_id: string;
         line_id: string | null;
         mac_ase_counter_value: number;
@@ -22,8 +28,11 @@ declare class SimplifiedApexOnBoardSalesNewClass extends ClickHouseInterfaceTemp
         pattern_id: string | null;
         stop_id: string | null;
         trip_id: string | null;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
         vehicle_id: number | null;
-        card_serial_number: string;
+        card_serial_number: bigint | null;
         block_id: string | null;
         card_physical_type: number;
         duty_id: string | null;

package/dist/interfaces/apex/simplified/simplified-apex-sales.js

@@ -4,36 +4,41 @@ import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
 import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */
 const tableSchema = {
-    _id: { primaryKey: true, type: 'String' },
-    agency_id: { type: 'String' },
-    apex_version: { type: 'String' },
-    block_id: { type: 'String' },
-    card_physical_type: { type: 'String' },
-    card_serial_number: { type: 'String' },
-    created_at: { type: 'Int64' },
-    device_id: { type: 'String' },
-    duty_id: { type: 'String' },
+    _id: { type: 'UUID' },
+    agency_id: { type: 'LowCardinality(String)' },
+    apex_version: { type: 'LowCardinality(String)' },
+    block_id: { type: 'Nullable(String)' },
+    calendar_date: { type: 'Date' },
+    card_physical_type: { type: 'UInt8' },
+    card_serial_number: { type: 'Nullable(UInt64)' },
+    created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    device_id: { type: 'LowCardinality(String)' },
+    duty_id: { type: 'Nullable(String)' },
     is_passenger: { type: 'Bool' },
-    line_id: { type: 'String' },
-    mac_ase_counter_value: { type: 'Int64' },
-    mac_sam_serial_number: { type: 'Int64' },
-    on_board_refund_id: { type: 'Nullable(String)' },
-    pattern_id: { type: 'String' },
-    payment_method: { type: 'String' },
-    price: { type: 'Int64' },
-    product_long_id: { type: 'String' },
-    product_quantity: { type: 'Int64' },
-    received_at: { type: 'Int64' },
-    stop_id: { type: 'String' },
-    trip_id: { type: 'String' },
-    validation_id: { type: 'Nullable(String)' },
-    vehicle_id: { type: 'String' },
+    line_id: { type: 'Nullable(LowCardinality(String))' },
+    mac_ase_counter_value: { type: 'UInt64' },
+    mac_sam_serial_number: { type: 'UInt64' },
+    on_board_refund_id: { type: 'Nullable(UUID)' },
+    pattern_id: { type: 'Nullable(LowCardinality(String))' },
+    payment_method: { type: 'UInt8' },
+    price: { type: 'Int32' },
+    product_long_id: { type: 'Nullable(LowCardinality(String))' },
+    product_quantity: { type: 'Int32' },
+    received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    stop_id: { type: 'Nullable(LowCardinality(String))' },
+    trip_id: { type: 'Nullable(String)' },
+    updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    validation_id: { type: 'Nullable(UUID)' },
+    vehicle_id: { type: 'Nullable(LowCardinality(String))' },
 };
 /* * */
 class SimplifiedApexOnBoardSalesNewClass extends ClickHouseInterfaceTemplate {
     //
     static _instance = null;
     databaseName = 'simplified_apex';
+    engine = 'ReplacingMergeTree(updated_at)';
+    orderBy = 'agency_id, created_at, _id';
+    partitionBy = 'toYYYYMM(created_at)';
     schema = tableSchema;
     tableName = 'sales';
     /**

package/dist/interfaces/apex/simplified/simplified-apex-validations.d.ts

@@ -1,10 +1,13 @@
 import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
-import { type ClickHouseSchema } from '../../../types/index.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../../../types/index.js';
 import { type SimplifiedApexValidation } from '@tmlmobilidade/go-types-apex';
 declare class SimplifiedApexValidationsNewClass extends ClickHouseInterfaceTemplate<SimplifiedApexValidation> {
     private static _instance;
     protected readonly databaseName = "simplified_apex";
-    protected readonly schema: ClickHouseSchema<{
+    protected readonly engine: ClickHouseTableEngine<SimplifiedApexValidation>;
+    protected readonly orderBy = "agency_id, created_at, _id";
+    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly schema: ClickHouseTableSchema<{
         _id: string;
         agency_id: string;
         created_at: number & {
@@ -15,24 +18,30 @@ declare class SimplifiedApexValidationsNewClass extends ClickHouseInterfaceTempl
             __brand: "UnixTimestamp";
         };
         apex_version: string;
+        calendar_date: string & {
+            __brand: "CalendarDate";
+        };
         device_id: string;
         event_type: number;
         is_ok_pcgi: boolean;
-        line_id: string;
+        line_id: string | null;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
-        pattern_id: string;
-        product_id: string;
-        stop_id: string;
+        pattern_id: string | null;
+        product_id: string | null;
+        stop_id: string | null;
         trip_id: string | null;
         units_qty: number | null;
-        vehicle_id: number;
-        card_serial_number: string;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
+        vehicle_id: number | null;
+        card_serial_number: bigint | null;
         on_board_sale_id: string | null;
         is_passenger: boolean;
         on_board_refund_id: string | null;
         category: "on_board_sale" | "prepaid" | "subscription" | null;
-        validation_status: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 10 | 7 | 8 | 9 | 11 | 12 | 13;
+        validation_status: "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13";
     }>;
     protected readonly tableName = "validations";
     /**

package/dist/interfaces/apex/simplified/simplified-apex-validations.js

@@ -4,36 +4,41 @@ import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
 import { asyncSingletonProxy } from '@tmlmobilidade/utils';
 /* * */
 const tableSchema = {
-    _id: { primaryKey: true, type: 'String' },
-    agency_id: { type: 'String' },
-    apex_version: { type: 'String' },
-    card_serial_number: { type: 'String' },
-    category: { type: 'String' },
-    created_at: { type: 'Int64' },
-    device_id: { type: 'String' },
-    event_type: { type: 'Int64' },
+    _id: { type: 'UUID' },
+    agency_id: { type: 'LowCardinality(String)' },
+    apex_version: { type: 'LowCardinality(String)' },
+    calendar_date: { type: 'Date' },
+    card_serial_number: { type: 'Nullable(UInt64)' },
+    category: { type: 'LowCardinality(String)' },
+    created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    device_id: { type: 'LowCardinality(String)' },
+    event_type: { type: 'UInt8' },
     is_ok: { type: 'Bool' },
     is_ok_pcgi: { type: 'Bool' },
     is_passenger: { type: 'Bool' },
-    line_id: { type: 'String' },
-    mac_ase_counter_value: { type: 'Int64' },
-    mac_sam_serial_number: { type: 'Int64' },
-    on_board_refund_id: { type: 'Nullable(String)' },
-    on_board_sale_id: { type: 'Nullable(String)' },
-    pattern_id: { type: 'String' },
-    product_id: { type: 'String' },
-    received_at: { type: 'Int64' },
-    stop_id: { type: 'String' },
-    trip_id: { type: 'String' },
-    units_qty: { type: 'Nullable(Int64)' },
-    validation_status: { type: 'Int64' },
-    vehicle_id: { type: 'String' },
+    line_id: { type: 'Nullable(LowCardinality(String))' },
+    mac_ase_counter_value: { type: 'UInt64' },
+    mac_sam_serial_number: { type: 'UInt64' },
+    on_board_refund_id: { type: 'Nullable(UUID)' },
+    on_board_sale_id: { type: 'Nullable(UUID)' },
+    pattern_id: { type: 'Nullable(LowCardinality(String))' },
+    product_id: { type: 'Nullable(LowCardinality(String))' },
+    received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    stop_id: { type: 'Nullable(LowCardinality(String))' },
+    trip_id: { type: 'Nullable(String)' },
+    units_qty: { type: 'Nullable(Int32)' },
+    updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+    validation_status: { type: 'UInt8' },
+    vehicle_id: { type: 'Nullable(LowCardinality(String))' },
 };
 /* * */
 class SimplifiedApexValidationsNewClass extends ClickHouseInterfaceTemplate {
     //
     static _instance = null;
     databaseName = 'simplified_apex';
+    engine = 'ReplacingMergeTree(updated_at)';
+    orderBy = 'agency_id, created_at, _id';
+    partitionBy = 'toYYYYMM(created_at)';
     schema = tableSchema;
     tableName = 'validations';
     /**

package/dist/interfaces/vehicle-events/simplified-vehicle-events.d.ts

@@ -3,16 +3,16 @@
  * These are stored in ClickHouse for performance and scalability reasons.
 **/
 import { ClickHouseInterfaceTemplate } from '../../templates/clickhouse.js';
-import { type ClickHouseSchema, ClickHouseTableEngine } from '../../types/index.js';
+import { type ClickHouseTableSchema, ClickHouseTableEngine } from '../../types/index.js';
 import { type SimplifiedVehicleEvent } from '@tmlmobilidade/types';
 declare class SimplifiedVehicleEventsNewClass extends ClickHouseInterfaceTemplate<SimplifiedVehicleEvent> {
     private static _instance;
     readonly databaseName = "operation";
-    readonly engine: ClickHouseTableEngine;
+    readonly engine: ClickHouseTableEngine<SimplifiedVehicleEvent>;
     readonly orderBy = "(operational_date, trip_id, vehicle_id, agency_id, created_at)";
     readonly partitionBy = "toYYYYMM(fromUnixTimestamp64Milli(created_at))";
     readonly primaryKey = "(operational_date, trip_id, vehicle_id)";
-    readonly schema: ClickHouseSchema<{
+    readonly schema: ClickHouseTableSchema<{
         _id: string;
         created_at: number & {
             __brand: "UnixTimestamp";

package/dist/interfaces/vehicle-events/simplified-vehicle-events.js

@@ -33,7 +33,7 @@ class SimplifiedVehicleEventsNewClass extends ClickHouseInterfaceTemplate {
     //
     static _instance = null;
     databaseName = 'operation';
-    engine = 'ReplacingMergeTree';
+    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)';

package/dist/templates/clickhouse.d.ts

@@ -1,12 +1,12 @@
-import { type ClickHouseSchema, type ClickHouseTableEngine } from '../types/index.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../types/index.js';
 import { queryFromFile } from '../utils/clickhouse/query-from-file.js';
 import { queryFromString } from '../utils/clickhouse/query-from-string.js';
 import { type ClickHouseClient, type DataFormat } from '@clickhouse/client';
 export declare abstract class ClickHouseInterfaceTemplate<T extends object> {
     protected readonly abstract databaseName: string;
-    protected readonly abstract schema: ClickHouseSchema<T>;
+    protected readonly abstract schema: ClickHouseTableSchema<T>;
     protected readonly abstract tableName: string;
-    protected readonly engine: ClickHouseTableEngine;
+    protected readonly engine: ClickHouseTableEngine<T>;
     /**
      * When `true` (default), `init()` runs `ensureDatabase()` + `ensureTable()` so
      * the schema is created from this class. Set to `false` for tables whose schema
@@ -131,9 +131,4 @@ export declare abstract class ClickHouseInterfaceTemplate<T extends object> {
      * @returns A promise that resolves when the table is ensured to exist.
      */
     private ensureTable;
-    /**
-     * Constructs the appropriate engine string based on the provided engine type.
-     * @throws Will throw an error if an unsupported engine type is provided.
-     */
-    private getEngineString;
 }

package/dist/templates/clickhouse.js

@@ -7,7 +7,7 @@ import { ClickHouseError } from '@clickhouse/client';
 import { Logger } from '@tmlmobilidade/logger';
 /* * */
 export class ClickHouseInterfaceTemplate {
-    engine = 'MergeTree';
+    engine = 'MergeTree()';
     /**
      * When `true` (default), `init()` runs `ensureDatabase()` + `ensureTable()` so
      * the schema is created from this class. Set to `false` for tables whose schema
@@ -209,7 +209,7 @@ export class ClickHouseInterfaceTemplate {
         const createTableQuery = `
 			CREATE TABLE IF NOT EXISTS "${this.databaseName}"."${this.tableName}" (
 				${Object.entries(this.schema).map(([key, column]) => `${key} ${column.type}`).join(', ')}
-			) ENGINE = ${this.getEngineString()}
+			) ENGINE = ${this.engine}
 			${this.primaryKey ? `PRIMARY KEY (${this.primaryKey})` : ''}
 			${this.orderBy ? `ORDER BY (${this.orderBy})` : ''}
 			${this.partitionBy ? `PARTITION BY (${this.partitionBy})` : ''}
@@ -244,18 +244,4 @@ export class ClickHouseInterfaceTemplate {
             }
         }
     }
-    /**
-     * Constructs the appropriate engine string based on the provided engine type.
-     * @throws Will throw an error if an unsupported engine type is provided.
-     */
-    getEngineString() {
-        switch (this.engine) {
-            case 'MergeTree':
-                return `MergeTree()`;
-            case 'ReplacingMergeTree':
-                return `ReplacingMergeTree()`;
-            default:
-                throw new Error(`CLICKHOUSE [${this.databaseName}/${this.tableName}]: Unsupported engine type: ${this.engine}`);
-        }
-    }
 }

package/dist/types/clickhouse/column.d.ts

@@ -6,8 +6,6 @@ import { type ClickHouseDataType } from './data-types.js';
 export interface ClickHouseColumn {
     /** Alias expression (computed on read) */
     alias?: string;
-    /** Column codec for compression */
-    codec?: string;
     /** Comment for the column */
     comment?: string;
     /** Default value expression */
@@ -18,16 +16,10 @@ export interface ClickHouseColumn {
     indexGranularity?: number;
     /** Type of skipping index. Default: 'minmax' */
     indexType?: 'bloom_filter' | 'minmax' | 'ngrambf_v1' | 'set' | 'tokenbf_v1';
-    /** Use LowCardinality wrapper for low-cardinality strings */
-    lowCardinality?: boolean;
     /** Materialized value expression (computed on insert) */
     materialized?: string;
     /** Whether the column can be null (wraps type in Nullable) */
     nullable?: boolean;
-    /** Include this column in the ORDER BY clause (ClickHouse's primary index) */
-    primaryKey?: boolean;
-    /** Order of this column in the primary key (lower = first). Default: 0 */
-    primaryKeyOrder?: number;
     /** TTL expression for this column */
     ttl?: string;
     /** The ClickHouse data type */
@@ -37,6 +29,6 @@ export interface ClickHouseColumn {
  * A ClickHouse schema is a mapping of column names to their definitions (ClickHouseColumn).
  * The generic type T represents the shape of the data, and the keys of T are used as column names.
  */
-export type ClickHouseSchema<T extends object> = {
+export type ClickHouseTableSchema<T extends object> = {
     [K in keyof T]: ClickHouseColumn;
 };

package/dist/types/clickhouse/data-types.d.ts

@@ -2,4 +2,4 @@
  * Supported ClickHouse data types that
  * can be used in ClickHouse table schemas.
  */
-export type ClickHouseDataType = 'Bool' | 'Boolean' | 'Date32' | 'Date' | 'DateTime' | 'Decimal' | 'Float32' | 'Float64' | 'Int8' | 'Int16' | 'Int32' | 'Int64' | 'Int128' | 'Int256' | 'String' | 'UInt8' | 'UInt16' | 'UInt32' | 'UInt64' | 'UInt128' | 'UInt256' | 'UUID' | `Array(${string})` | `DateTime64(${number})` | `Decimal(${number}, ${number})` | `Enum8(${string})` | `Enum16(${string})` | `FixedString(${number})` | `LowCardinality(${string})` | `Map(${string}, ${string})` | `Nullable(${string})`;
+export type ClickHouseDataType = 'Bool' | 'Date' | 'Float64' | 'Int32' | 'Int64' | 'String' | 'UInt8' | 'UInt64' | 'UUID' | `DateTime64(3, 'UTC') CODEC(Delta, ZSTD)` | `Enum8(${string})` | `LowCardinality(String)` | `Nullable(Float64)` | `Nullable(Int32)` | `Nullable(Int64)` | `Nullable(LowCardinality(String))` | `Nullable(String)` | `Nullable(UInt64)` | `Nullable(UUID)`;

package/dist/types/clickhouse/table-engines.d.ts

@@ -3,4 +3,4 @@
  * Please avoid using other engines before consulting with the team
  * as ClickHouse has many engines with different features and limitations.
  */
-export type ClickHouseTableEngine = 'MergeTree' | 'ReplacingMergeTree';
+export type ClickHouseTableEngine<T extends object> = 'MergeTree()' | `ReplacingMergeTree(${Extract<keyof T, string>})`;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/databases",
-	"version": "20260616.1147.27",
+	"version": "20260616.2238.2",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"