@tmlmobilidade/databases 20260616.2252.19 → 20260617.1318.33

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

@@ -19,9 +19,6 @@ 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;

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

@@ -8,7 +8,6 @@ const tableSchema = {
     agency_id: { type: 'LowCardinality(String)' },
     apex_version: { type: 'LowCardinality(String)' },
     banking_token: { type: 'String' },
-    calendar_date: { type: 'Date' },
     card_brand: { type: 'UInt8' },
     card_pan: { type: 'String' },
     created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },

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

@@ -18,9 +18,6 @@ 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;

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

@@ -7,7 +7,6 @@ const tableSchema = {
     _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' },

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

@@ -18,9 +18,6 @@ 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;
@@ -33,7 +30,7 @@ declare class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTempl
             __brand: "UnixTimestamp";
         };
         vehicle_id: number | null;
-        card_serial_number: bigint | null;
+        card_serial_number: string | null;
         control_destination_stop_id: string;
         control_origin_stop_id: string;
         control_status: number;

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

@@ -7,10 +7,9 @@ const tableSchema = {
     _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_destination_stop_id: { type: 'LowCardinality(Nullable(String))' },
+    control_origin_stop_id: { type: 'LowCardinality(Nullable(String))' },
     control_status: { type: 'UInt8' },
     created_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
     device_id: { type: 'LowCardinality(String)' },
@@ -18,15 +17,15 @@ const tableSchema = {
     inspection_id: { type: 'Nullable(UUID)' },
     is_ok: { type: 'Bool' },
     is_ok_pcgi: { type: 'Bool' },
-    line_id: { type: 'Nullable(LowCardinality(String))' },
+    line_id: { type: 'LowCardinality(Nullable(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))' },
+    pattern_id: { type: 'LowCardinality(Nullable(String))' },
+    product_id: { type: 'LowCardinality(Nullable(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))' },
+    vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
 /* * */
 class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTemplate {

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

@@ -17,9 +17,6 @@ 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;

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

@@ -7,18 +7,17 @@ const tableSchema = {
     _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))' },
+    line_id: { type: 'LowCardinality(Nullable(String))' },
     mac_ase_counter_value: { type: 'UInt64' },
     mac_sam_serial_number: { type: 'UInt64' },
-    pattern_id: { type: 'Nullable(LowCardinality(String))' },
+    pattern_id: { type: 'LowCardinality(Nullable(String))' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
-    stop_id: { type: 'Nullable(LowCardinality(String))' },
+    stop_id: { type: 'LowCardinality(Nullable(String))' },
     trip_id: { type: 'Nullable(String)' },
     updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
-    vehicle_id: { type: 'Nullable(LowCardinality(String))' },
+    vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
 /* * */
 class SimplifiedApexLocationsNewClass extends ClickHouseInterfaceTemplate {

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

@@ -18,27 +18,24 @@ 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;
         mac_sam_serial_number: number;
         pattern_id: string | null;
+        product_id: string;
         stop_id: string | null;
         trip_id: string | null;
         updated_at: number & {
             __brand: "UnixTimestamp";
         };
         vehicle_id: number | null;
-        card_serial_number: bigint | null;
+        card_serial_number: string | null;
         block_id: string | null;
         card_physical_type: number;
         duty_id: string | null;
         on_board_sale_id: string | null;
         payment_method: number;
-        product_long_id: string;
         product_quantity: number;
         validation_id: string | null;
     }>;

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

@@ -8,27 +8,26 @@ const tableSchema = {
     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))' },
+    line_id: { type: 'LowCardinality(Nullable(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))' },
+    pattern_id: { type: 'LowCardinality(Nullable(String))' },
     payment_method: { type: 'UInt8' },
     price: { type: 'Int32' },
-    product_long_id: { type: 'Nullable(LowCardinality(String))' },
+    product_id: { type: 'LowCardinality(Nullable(String))' },
     product_quantity: { type: 'Int32' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
-    stop_id: { type: 'Nullable(LowCardinality(String))' },
+    stop_id: { type: 'LowCardinality(Nullable(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))' },
+    vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
 /* * */
 class SimplifiedApexOnBoardRefundsNewClass extends ClickHouseInterfaceTemplate {

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

@@ -18,26 +18,23 @@ 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;
         mac_sam_serial_number: number;
         pattern_id: string | null;
+        product_id: string;
         stop_id: string | null;
         trip_id: string | null;
         updated_at: number & {
             __brand: "UnixTimestamp";
         };
         vehicle_id: number | null;
-        card_serial_number: bigint | null;
+        card_serial_number: string | null;
         block_id: string | null;
         card_physical_type: number;
         duty_id: string | null;
         payment_method: number;
-        product_long_id: string;
         product_quantity: number;
         validation_id: string | null;
         is_passenger: boolean;

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

@@ -8,28 +8,27 @@ const tableSchema = {
     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: 'Nullable(LowCardinality(String))' },
+    line_id: { type: 'LowCardinality(Nullable(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))' },
+    pattern_id: { type: 'LowCardinality(Nullable(String))' },
     payment_method: { type: 'UInt8' },
     price: { type: 'Int32' },
-    product_long_id: { type: 'Nullable(LowCardinality(String))' },
+    product_id: { type: 'LowCardinality(Nullable(String))' },
     product_quantity: { type: 'Int32' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
-    stop_id: { type: 'Nullable(LowCardinality(String))' },
+    stop_id: { type: 'LowCardinality(Nullable(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))' },
+    vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
 /* * */
 class SimplifiedApexOnBoardSalesNewClass extends ClickHouseInterfaceTemplate {

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

@@ -18,9 +18,6 @@ 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;
@@ -36,11 +33,11 @@ declare class SimplifiedApexValidationsNewClass extends ClickHouseInterfaceTempl
             __brand: "UnixTimestamp";
         };
         vehicle_id: number | null;
-        card_serial_number: bigint | null;
+        card_serial_number: string | null;
         on_board_sale_id: string | null;
         is_passenger: boolean;
         on_board_refund_id: string | null;
-        category: "on_board_sale" | "prepaid" | "subscription" | null;
+        category: "prepaid" | "subscription" | "on_board_sale" | null;
         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

@@ -7,7 +7,6 @@ const tableSchema = {
     _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)' },
@@ -16,20 +15,20 @@ const tableSchema = {
     is_ok: { type: 'Bool' },
     is_ok_pcgi: { type: 'Bool' },
     is_passenger: { type: 'Bool' },
-    line_id: { type: 'Nullable(LowCardinality(String))' },
+    line_id: { type: 'LowCardinality(Nullable(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))' },
+    pattern_id: { type: 'LowCardinality(Nullable(String))' },
+    product_id: { type: 'LowCardinality(Nullable(String))' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
-    stop_id: { type: 'Nullable(LowCardinality(String))' },
+    stop_id: { type: 'LowCardinality(Nullable(String))' },
     trip_id: { type: 'Nullable(String)' },
     units_qty: { type: 'Nullable(Int32)' },
     updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
     validation_status: { type: 'LowCardinality(String)' },
-    vehicle_id: { type: 'Nullable(LowCardinality(String))' },
+    vehicle_id: { type: 'LowCardinality(Nullable(String))' },
 };
 /* * */
 class SimplifiedApexValidationsNewClass extends ClickHouseInterfaceTemplate {

package/dist/templates/clickhouse.d.ts

@@ -37,7 +37,7 @@ export declare abstract class ClickHouseInterfaceTemplate<T extends object> {
      * @param params Optional key-value substitutions applied to the WHERE clause (replaces $1, $2, etc.).
      * @returns A promise that resolves when the delete operation is complete.
      */
-    delete(where: string, params?: Record<string, number | string>): Promise<void>;
+    delete(where: string, params?: Record<string, number | string | string[]>): Promise<void>;
     /**
      * Executes a DISTINCT query on the ClickHouse table using the service's client.
      * @param select The columns to select in the query (e.g., `"*"`, `"column1, column2"`).

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' | '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)`;
+export type ClickHouseDataType = 'Bool' | 'Date' | 'Float64' | 'Int32' | 'Int64' | 'String' | 'UInt8' | 'UInt64' | 'UUID' | `DateTime64(3, 'UTC') CODEC(Delta, ZSTD)` | `Enum8(${string})` | `LowCardinality(Nullable(String))` | `LowCardinality(String)` | `Nullable(Float64)` | `Nullable(Int32)` | `Nullable(Int64)` | `Nullable(String)` | `Nullable(UInt64)` | `Nullable(UUID)`;

package/dist/utils/clickhouse/get-clickhouse-param-type.d.ts

@@ -4,4 +4,4 @@
  * @param value
  * @returns
  */
-export declare function getClickHouseParamType(value: number | string): 'Float64' | 'Int64' | 'String';
+export declare function getClickHouseParamType(value: number | string | string[]): 'Array(String)' | 'Float64' | 'Int64' | 'String';

package/dist/utils/clickhouse/get-clickhouse-param-type.js

@@ -12,5 +12,8 @@ export function getClickHouseParamType(value) {
         }
         return Number.isInteger(value) ? 'Int64' : 'Float64';
     }
+    if (Array.isArray(value)) {
+        return 'Array(String)';
+    }
     return 'String';
 }

package/dist/utils/clickhouse/prepare-positional-query-params.d.ts

@@ -7,7 +7,7 @@
  * @throws Will throw an error if a placeholder is missing a corresponding parameter, if there are unused parameters, or if any parameter keys are invalid.
  * @returns An object containing the transformed query and a mapping of named parameters to their values.
  */
-export declare function preparePositionalQueryParams(query: string, params?: Record<string, number | string>): {
+export declare function preparePositionalQueryParams(query: string, params?: Record<string, number | string | string[]>): {
     query: string;
-    query_params: Record<string, number | string>;
+    query_params: Record<string, number | string | string[]>;
 };

package/package.json

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