@tmlmobilidade/databases 20260618.2315.12 → 20260620.1032.31

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

@@ -5,8 +5,8 @@ declare class SimplifiedApexBankingTapsNewClass extends ClickHouseInterfaceTempl
     private static _instance;
     protected readonly databaseName = "simplified_apex";
     protected readonly engine: ClickHouseTableEngine<SimplifiedApexBankingTap>;
-    protected readonly orderBy = "agency_id, created_at, _id";
-    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly orderBy = "agency_id, operational_date, created_at, _id";
+    protected readonly partitionBy = "intDiv(operational_date, 100)";
     protected readonly schema: ClickHouseTableSchema<{
         is_ok: boolean;
         _id: string;
@@ -28,6 +28,9 @@ declare class SimplifiedApexBankingTapsNewClass extends ClickHouseInterfaceTempl
         line_id: string | null;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
+        operational_date: number & {
+            __brand: "OperationalDateInt";
+        };
         pattern_id: string | null;
         product_id: string | null;
         stop_id: string;

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

@@ -19,6 +19,7 @@ const tableSchema = {
     line_id: { type: 'LowCardinality(String)' },
     mac_ase_counter_value: { type: 'UInt64' },
     mac_sam_serial_number: { type: 'UInt64' },
+    operational_date: { type: 'UInt32' },
     pattern_id: { type: 'LowCardinality(String)' },
     product_id: { type: 'LowCardinality(String)' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
@@ -33,8 +34,8 @@ class SimplifiedApexBankingTapsNewClass extends ClickHouseInterfaceTemplate {
     static _instance = null;
     databaseName = 'simplified_apex';
     engine = 'ReplacingMergeTree(updated_at)';
-    orderBy = 'agency_id, created_at, _id';
-    partitionBy = 'toYYYYMM(created_at)';
+    orderBy = 'agency_id, operational_date, created_at, _id';
+    partitionBy = 'intDiv(operational_date, 100)';
     schema = tableSchema;
     tableName = 'banking_taps';
     /**

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

@@ -5,8 +5,8 @@ declare class SimplifiedApexInspectionDecisionsNewClass extends ClickHouseInterf
     private static _instance;
     protected readonly databaseName = "simplified_apex";
     protected readonly engine: ClickHouseTableEngine<SimplifiedApexInspectionDecision>;
-    protected readonly orderBy = "agency_id, created_at, _id";
-    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly orderBy = "agency_id, operational_date, created_at, _id";
+    protected readonly partitionBy = "intDiv(operational_date, 100)";
     protected readonly schema: ClickHouseTableSchema<{
         is_ok: boolean;
         _id: string;
@@ -22,6 +22,9 @@ declare class SimplifiedApexInspectionDecisionsNewClass extends ClickHouseInterf
         is_ok_pcgi: boolean;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
+        operational_date: number & {
+            __brand: "OperationalDateInt";
+        };
         updated_at: number & {
             __brand: "UnixTimestamp";
         };

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

@@ -15,6 +15,7 @@ const tableSchema = {
     is_ok_pcgi: { type: 'Bool' },
     mac_ase_counter_value: { type: 'UInt64' },
     mac_sam_serial_number: { type: 'UInt64' },
+    operational_date: { type: 'UInt32' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
     updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
 };
@@ -24,8 +25,8 @@ class SimplifiedApexInspectionDecisionsNewClass extends ClickHouseInterfaceTempl
     static _instance = null;
     databaseName = 'simplified_apex';
     engine = 'ReplacingMergeTree(updated_at)';
-    orderBy = 'agency_id, created_at, _id';
-    partitionBy = 'toYYYYMM(created_at)';
+    orderBy = 'agency_id, operational_date, created_at, _id';
+    partitionBy = 'intDiv(operational_date, 100)';
     schema = tableSchema;
     tableName = 'inspection_decisions';
     /**

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

@@ -5,8 +5,8 @@ declare class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTempl
     private static _instance;
     protected readonly databaseName = "simplified_apex";
     protected readonly engine: ClickHouseTableEngine<SimplifiedApexInspection>;
-    protected readonly orderBy = "agency_id, created_at, _id";
-    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly orderBy = "agency_id, operational_date, created_at, _id";
+    protected readonly partitionBy = "intDiv(operational_date, 100)";
     protected readonly schema: ClickHouseTableSchema<{
         is_ok: boolean;
         _id: string;
@@ -23,6 +23,9 @@ declare class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTempl
         line_id: string;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
+        operational_date: number & {
+            __brand: "OperationalDateInt";
+        };
         pattern_id: string | null;
         product_id: string | null;
         trip_id: string | null;

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

@@ -20,6 +20,7 @@ const tableSchema = {
     line_id: { type: 'LowCardinality(Nullable(String))' },
     mac_ase_counter_value: { type: 'UInt64' },
     mac_sam_serial_number: { type: 'UInt64' },
+    operational_date: { type: 'UInt32' },
     pattern_id: { type: 'LowCardinality(Nullable(String))' },
     product_id: { type: 'LowCardinality(Nullable(String))' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
@@ -33,8 +34,8 @@ class SimplifiedApexInspectionsNewClass extends ClickHouseInterfaceTemplate {
     static _instance = null;
     databaseName = 'simplified_apex';
     engine = 'ReplacingMergeTree(updated_at)';
-    orderBy = 'agency_id, created_at, _id';
-    partitionBy = 'toYYYYMM(created_at)';
+    orderBy = 'agency_id, operational_date, created_at, _id';
+    partitionBy = 'intDiv(operational_date, 100)';
     schema = tableSchema;
     tableName = 'inspections';
     /**

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

@@ -5,8 +5,8 @@ declare class SimplifiedApexLocationsNewClass extends ClickHouseInterfaceTemplat
     private static _instance;
     protected readonly databaseName = "simplified_apex";
     protected readonly engine: ClickHouseTableEngine<SimplifiedApexLocation>;
-    protected readonly orderBy = "agency_id, created_at, _id";
-    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly orderBy = "agency_id, operational_date, created_at, _id";
+    protected readonly partitionBy = "intDiv(operational_date, 100)";
     protected readonly schema: ClickHouseTableSchema<{
         is_ok: boolean;
         _id: string;
@@ -23,6 +23,9 @@ declare class SimplifiedApexLocationsNewClass extends ClickHouseInterfaceTemplat
         line_id: string;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
+        operational_date: number & {
+            __brand: "OperationalDateInt";
+        };
         pattern_id: string;
         stop_id: string;
         trip_id: string | null;

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

@@ -14,6 +14,7 @@ const tableSchema = {
     line_id: { type: 'LowCardinality(Nullable(String))' },
     mac_ase_counter_value: { type: 'UInt64' },
     mac_sam_serial_number: { type: 'UInt64' },
+    operational_date: { type: 'UInt32' },
     pattern_id: { type: 'LowCardinality(Nullable(String))' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
     stop_id: { type: 'LowCardinality(Nullable(String))' },
@@ -27,8 +28,8 @@ class SimplifiedApexLocationsNewClass extends ClickHouseInterfaceTemplate {
     static _instance = null;
     databaseName = 'simplified_apex';
     engine = 'ReplacingMergeTree(updated_at)';
-    orderBy = 'agency_id, created_at, _id';
-    partitionBy = 'toYYYYMM(created_at)';
+    orderBy = 'agency_id, operational_date, created_at, _id';
+    partitionBy = 'intDiv(operational_date, 100)';
     schema = tableSchema;
     tableName = 'locations';
     /**

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

@@ -5,8 +5,8 @@ declare class SimplifiedApexOnBoardRefundsNewClass extends ClickHouseInterfaceTe
     private static _instance;
     protected readonly databaseName = "simplified_apex";
     protected readonly engine: ClickHouseTableEngine<SimplifiedApexOnBoardRefund>;
-    protected readonly orderBy = "agency_id, created_at, _id";
-    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly orderBy = "agency_id, operational_date, created_at, _id";
+    protected readonly partitionBy = "intDiv(operational_date, 100)";
     protected readonly schema: ClickHouseTableSchema<{
         is_ok: boolean;
         _id: string;
@@ -24,6 +24,9 @@ declare class SimplifiedApexOnBoardRefundsNewClass extends ClickHouseInterfaceTe
         line_id: string | null;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
+        operational_date: number & {
+            __brand: "OperationalDateInt";
+        };
         pattern_id: string | null;
         product_id: string;
         stop_id: string | null;

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

@@ -17,6 +17,7 @@ const tableSchema = {
     mac_ase_counter_value: { type: 'UInt64' },
     mac_sam_serial_number: { type: 'UInt64' },
     on_board_sale_id: { type: 'Nullable(UUID)' },
+    operational_date: { type: 'UInt32' },
     pattern_id: { type: 'LowCardinality(Nullable(String))' },
     payment_method: { type: 'UInt8' },
     price: { type: 'Int32' },
@@ -35,8 +36,8 @@ class SimplifiedApexOnBoardRefundsNewClass extends ClickHouseInterfaceTemplate {
     static _instance = null;
     databaseName = 'simplified_apex';
     engine = 'ReplacingMergeTree(updated_at)';
-    orderBy = 'agency_id, created_at, _id';
-    partitionBy = 'toYYYYMM(created_at)';
+    orderBy = 'agency_id, operational_date, created_at, _id';
+    partitionBy = 'intDiv(operational_date, 100)';
     schema = tableSchema;
     tableName = 'refunds';
     /**

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

@@ -5,8 +5,8 @@ declare class SimplifiedApexOnBoardSalesNewClass extends ClickHouseInterfaceTemp
     private static _instance;
     protected readonly databaseName = "simplified_apex";
     protected readonly engine: ClickHouseTableEngine<SimplifiedApexOnBoardSale>;
-    protected readonly orderBy = "agency_id, created_at, _id";
-    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly orderBy = "agency_id, operational_date, created_at, _id";
+    protected readonly partitionBy = "intDiv(operational_date, 100)";
     protected readonly schema: ClickHouseTableSchema<{
         is_ok: boolean;
         _id: string;
@@ -24,6 +24,9 @@ declare class SimplifiedApexOnBoardSalesNewClass extends ClickHouseInterfaceTemp
         line_id: string | null;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
+        operational_date: number & {
+            __brand: "OperationalDateInt";
+        };
         pattern_id: string | null;
         product_id: string;
         stop_id: string | null;

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

@@ -18,6 +18,7 @@ const tableSchema = {
     mac_ase_counter_value: { type: 'UInt64' },
     mac_sam_serial_number: { type: 'UInt64' },
     on_board_refund_id: { type: 'Nullable(UUID)' },
+    operational_date: { type: 'UInt32' },
     pattern_id: { type: 'LowCardinality(Nullable(String))' },
     payment_method: { type: 'UInt8' },
     price: { type: 'Int32' },
@@ -36,8 +37,8 @@ class SimplifiedApexOnBoardSalesNewClass extends ClickHouseInterfaceTemplate {
     static _instance = null;
     databaseName = 'simplified_apex';
     engine = 'ReplacingMergeTree(updated_at)';
-    orderBy = 'agency_id, created_at, _id';
-    partitionBy = 'toYYYYMM(created_at)';
+    orderBy = 'agency_id, operational_date, created_at, _id';
+    partitionBy = 'intDiv(operational_date, 100)';
     schema = tableSchema;
     tableName = 'sales';
     /**

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

@@ -5,8 +5,8 @@ declare class SimplifiedApexValidationsNewClass extends ClickHouseInterfaceTempl
     private static _instance;
     protected readonly databaseName = "simplified_apex";
     protected readonly engine: ClickHouseTableEngine<SimplifiedApexValidation>;
-    protected readonly orderBy = "agency_id, created_at, _id";
-    protected readonly partitionBy = "toYYYYMM(created_at)";
+    protected readonly orderBy = "agency_id, operational_date, created_at, _id";
+    protected readonly partitionBy = "intDiv(operational_date, 100)";
     protected readonly schema: ClickHouseTableSchema<{
         is_passenger: boolean;
         is_ok: boolean;
@@ -26,6 +26,9 @@ declare class SimplifiedApexValidationsNewClass extends ClickHouseInterfaceTempl
         line_id: string | null;
         mac_ase_counter_value: number;
         mac_sam_serial_number: number;
+        operational_date: number & {
+            __brand: "OperationalDateInt";
+        };
         pattern_id: string | null;
         product_id: string | null;
         stop_id: string | null;

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

@@ -20,6 +20,7 @@ const tableSchema = {
     mac_sam_serial_number: { type: 'UInt64' },
     on_board_refund_id: { type: 'Nullable(UUID)' },
     on_board_sale_id: { type: 'Nullable(UUID)' },
+    operational_date: { type: 'UInt32' },
     pattern_id: { type: 'LowCardinality(Nullable(String))' },
     product_id: { type: 'LowCardinality(Nullable(String))' },
     received_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
@@ -36,8 +37,8 @@ class SimplifiedApexValidationsNewClass extends ClickHouseInterfaceTemplate {
     static _instance = null;
     databaseName = 'simplified_apex';
     engine = 'ReplacingMergeTree(updated_at)';
-    orderBy = 'agency_id, created_at, _id';
-    partitionBy = 'toYYYYMM(created_at)';
+    orderBy = 'agency_id, operational_date, created_at, _id';
+    partitionBy = 'intDiv(operational_date, 100)';
     schema = tableSchema;
     tableName = 'validations';
     /**

package/dist/interfaces/index.d.ts

@@ -1,4 +1,5 @@
 export * from './apex/index.js';
 export * from './api-cache/index.js';
 export * from './pcgi/index.js';
+export * from './performance/index.js';
 export * from './vehicle-events/index.js';

package/dist/interfaces/index.js

@@ -1,4 +1,5 @@
 export * from './apex/index.js';
 export * from './api-cache/index.js';
 export * from './pcgi/index.js';
+export * from './performance/index.js';
 export * from './vehicle-events/index.js';

package/dist/interfaces/performance/demand/demand-by-agency-by-operational-date.d.ts

@@ -0,0 +1,29 @@
+import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
+import { type ClickHouseTableEngine, type ClickHouseTableSchema } from '../../../types/index.js';
+import { type DemandByAgencyByOperationalDate } from '@tmlmobilidade/go-types-performance';
+declare class DemandByAgencyByOperationalDateClass extends ClickHouseInterfaceTemplate<DemandByAgencyByOperationalDate> {
+    private static _instance;
+    protected readonly databaseName = "performance";
+    protected readonly engine: ClickHouseTableEngine<DemandByAgencyByOperationalDate>;
+    protected readonly orderBy = "operational_date, agency_id";
+    protected readonly partitionBy = "intDiv(operational_date, 100)";
+    protected readonly schema: ClickHouseTableSchema<{
+        agency_id: string;
+        operational_date: string & {
+            __brand: "OperationalDate";
+        };
+        qty: number;
+        updated_at: number & {
+            __brand: "UnixTimestamp";
+        };
+    }>;
+    protected readonly tableName = "demand_by_agency_by_operational_date";
+    /**
+     * Returns the singleton instance of the subclass.
+     */
+    static getInstance(): Promise<DemandByAgencyByOperationalDateClass>;
+    protected connectToClient(): Promise<import("@clickhouse/client").ClickHouseClient>;
+    protected postInit(): Promise<void>;
+}
+export declare const demandByAgencyByOperationalDate: DemandByAgencyByOperationalDateClass;
+export {};

package/dist/interfaces/performance/demand/demand-by-agency-by-operational-date.js

@@ -0,0 +1,50 @@
+/* * */
+import { GOClickHouseClient } from '../../../clients/go-clickhouse.js';
+import { ClickHouseInterfaceTemplate } from '../../../templates/clickhouse.js';
+import { asyncSingletonProxy } from '@tmlmobilidade/utils';
+/* * */
+const tableSchema = {
+    agency_id: { type: 'LowCardinality(String)' },
+    operational_date: { type: 'UInt32' },
+    qty: { type: 'UInt64' },
+    updated_at: { type: 'DateTime64(3, \'UTC\') CODEC(Delta, ZSTD)' },
+};
+/* * */
+class DemandByAgencyByOperationalDateClass extends ClickHouseInterfaceTemplate {
+    //
+    static _instance = null;
+    databaseName = 'performance';
+    engine = 'ReplacingMergeTree(updated_at)';
+    orderBy = 'operational_date, agency_id';
+    partitionBy = 'intDiv(operational_date, 100)';
+    schema = tableSchema;
+    tableName = 'demand_by_agency_by_operational_date';
+    /**
+     * Returns the singleton instance of the subclass.
+     */
+    static async getInstance() {
+        // If no instance exists, create one and store the promise.
+        // This ensures that if multiple calls to getInstance() happen concurrently,
+        // they will all await the same initialization process.
+        if (!this._instance) {
+            this._instance = (async () => {
+                const instance = new DemandByAgencyByOperationalDateClass();
+                // This behaves like the constructor,
+                // but allows for async initialization.
+                await instance.init();
+                return instance;
+            })();
+        }
+        // Await the instance if it's still initializing,
+        // or return it immediately if ready.
+        return await this._instance;
+    }
+    connectToClient() {
+        return GOClickHouseClient.getClient();
+    }
+    async postInit() {
+        console.log('Post init ClickHouse service for Demand by Agency by Operational Date...');
+    }
+}
+/* * */
+export const demandByAgencyByOperationalDate = asyncSingletonProxy(DemandByAgencyByOperationalDateClass);

package/dist/interfaces/performance/demand/index.d.ts

@@ -0,0 +1 @@
+export * from './demand-by-agency-by-operational-date.js';

package/dist/interfaces/performance/demand/index.js

@@ -0,0 +1 @@
+export * from './demand-by-agency-by-operational-date.js';

package/dist/interfaces/performance/index.d.ts

@@ -0,0 +1 @@
+export * from './demand/index.js';

package/dist/interfaces/performance/index.js

@@ -0,0 +1 @@
+export * from './demand/index.js';

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(Nullable(String))` | `LowCardinality(String)` | `Nullable(Float64)` | `Nullable(Int32)` | `Nullable(Int64)` | `Nullable(String)` | `Nullable(UInt64)` | `Nullable(UUID)`;
+export type ClickHouseDataType = 'Bool' | 'Date' | 'Float64' | 'Int32' | 'Int64' | 'String' | 'UInt8' | 'UInt32' | '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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@tmlmobilidade/databases",
-	"version": "20260618.2315.12",
+	"version": "20260620.1032.31",
 	"author": {
 		"email": "iso@tmlmobilidade.pt",
 		"name": "TML-ISO"
@@ -38,6 +38,7 @@
 	"dependencies": {
 		"@clickhouse/client": "1.21.0",
 		"@tmlmobilidade/go-types-apex": "*",
+		"@tmlmobilidade/go-types-performance": "*",
 		"@tmlmobilidade/logger": "*",
 		"@tmlmobilidade/ssh": "*",
 		"@tmlmobilidade/types": "*",