@trafficgroup/knex-rel 0.0.28 → 0.1.0

package/.claude/settings.local.json

@@ -1,9 +1,6 @@
 {
   "permissions": {
-    "allow": [
-      "Bash(npm run migrate:*)",
-      "Bash(mkdir:*)"
-    ],
+    "allow": ["Bash(npm run migrate:*)", "Bash(mkdir:*)"],
     "deny": []
   }
-}
+}

package/CLAUDE.md

@@ -1,63 +1,72 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is `@trafficgroup/knex-rel` - a TypeScript-based Knex.js module for database operations with PostgreSQL. It provides a standardized data access layer with DAOs (Data Access Objects) and interfaces for various entities.
-
-## Development Commands
-
-### Building and Formatting
-- `npm run build` - Compile TypeScript to JavaScript in dist/
-- `npm run format` - Format code with Prettier
-- `npm run clean` - Clean dist/, format, and rebuild
-- `npm test` - Run Jest tests
-
-### Database Operations
-- `npm run migrate:create` - Create a new TypeScript migration file
-- `npm run migrate:deploy` - Run all pending migrations
-- `npm run seed:create` - Create a new TypeScript seed file  
-- `npm run seed:run` - Execute all seed files
-
-### Publishing
-- `npm run npm:publish` - Clean, build, and publish to npm
-
-## Architecture
-
-### Core Components
-
-**KnexManager** (`src/KnexConnection.ts`): Singleton connection manager
-- `connect(config?, connections?)` - Establish database connection
-- `getConnection()` - Get active connection instance
-- `disconnect()` - Close connection and cleanup
-
-**DAO Pattern**: All data access follows the `IBaseDAO<T>` interface with standard CRUD operations:
-- `create(item)`, `getById(id)`, `getByUuid(uuid)`, `getAll(page, limit)`, `update(id, item)`, `delete(id)`
-- Returns `IDataPaginator<T>` for paginated results
-
-**AuthDAO Additional Methods**:
-- `getByUserId(userId: number)` - Find auth record by user ID
-- `getByEmailToken(emailToken: string)` - Find auth record by email verification/reset token
-
-### Entity Structure
-
-Each entity has:
-- Interface in `src/interfaces/[entity]/[entity].interfaces.ts`
-- DAO implementation in `src/dao/[entity]/[entity].dao.ts`
-
-Current entities: User, Study, Folder, Video
-
-### Database Configuration
-
-Environment variables (for development):
-- `SQL_HOST`, `SQL_USER`, `SQL_PASSWORD`, `SQL_DB_NAME`, `SQL_PORT`
-
-Environment variables (for staging/production):
-- `PG_HOST`, `PG_USER`, `PG_PASSWORD`, `PG_DB`, `PG_PORT`
-
-Knex configuration supports development, staging, and production environments in `knexfile.ts`.
-
-### Migrations
-
-Located in `migrations/` directory. Use TypeScript format with timestamp prefixes. Database uses `knex_migrations` table for tracking.
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is `@trafficgroup/knex-rel` - a TypeScript-based Knex.js module for database operations with PostgreSQL. It provides a standardized data access layer with DAOs (Data Access Objects) and interfaces for various entities.
+
+## Development Commands
+
+### Building and Formatting
+
+- `npm run build` - Compile TypeScript to JavaScript in dist/
+- `npm run format` - Format code with Prettier
+- `npm run clean` - Clean dist/, format, and rebuild
+- `npm test` - Run Jest tests
+
+### Database Operations
+
+- `npm run migrate:create` - Create a new TypeScript migration file
+- `npm run migrate:deploy` - Run all pending migrations
+- `npm run seed:create` - Create a new TypeScript seed file
+- `npm run seed:run` - Execute all seed files
+
+### Publishing
+
+- `npm run npm:publish` - Clean, build, and publish to npm
+
+## Architecture
+
+### Core Components
+
+**KnexManager** (`src/KnexConnection.ts`): Singleton connection manager
+
+- `connect(config?, connections?)` - Establish database connection
+- `getConnection()` - Get active connection instance
+- `disconnect()` - Close connection and cleanup
+
+**DAO Pattern**: All data access follows the `IBaseDAO<T>` interface with standard CRUD operations:
+
+- `create(item)`, `getById(id)`, `getByUuid(uuid)`, `getAll(page, limit)`, `update(id, item)`, `delete(id)`
+- Returns `IDataPaginator<T>` for paginated results
+
+**AuthDAO Additional Methods**:
+
+- `getByUserId(userId: number)` - Find auth record by user ID
+- `getByEmailToken(emailToken: string)` - Find auth record by email verification/reset token
+
+### Entity Structure
+
+Each entity has:
+
+- Interface in `src/interfaces/[entity]/[entity].interfaces.ts`
+- DAO implementation in `src/dao/[entity]/[entity].dao.ts`
+
+Current entities: User, Study, Folder, Video
+
+### Database Configuration
+
+Environment variables (for development):
+
+- `SQL_HOST`, `SQL_USER`, `SQL_PASSWORD`, `SQL_DB_NAME`, `SQL_PORT`
+
+Environment variables (for staging/production):
+
+- `PG_HOST`, `PG_USER`, `PG_PASSWORD`, `PG_DB`, `PG_PORT`
+
+Knex configuration supports development, staging, and production environments in `knexfile.ts`.
+
+### Migrations
+
+Located in `migrations/` directory. Use TypeScript format with timestamp prefixes. Database uses `knex_migrations` table for tracking.

package/dist/dao/VideoMinuteResultDAO.d.ts

@@ -0,0 +1,149 @@
+import { IBaseDAO, IDataPaginator } from "../d.types";
+import { IVideoMinuteResult, IVideoMinuteResultInput } from "../entities/VideoMinuteResult";
+interface ITMCTurnMovements {
+    straight: number;
+    left: number;
+    right: number;
+    "u-turn": number;
+    [key: string]: number;
+}
+interface ITMCDirections {
+    [direction: string]: ITMCTurnMovements;
+}
+interface ITMCVehicles {
+    [vehicleClass: string]: ITMCDirections;
+}
+interface ITMCResult {
+    vehicles: ITMCVehicles;
+    counts: {
+        total_vehicles: number;
+        entry_vehicles: number;
+    };
+    total: number;
+    totalcount: number;
+    detected_classes: {
+        [vehicleClass: string]: number;
+    };
+    study_type: "TMC";
+}
+interface IATRVehicles {
+    [vehicleClass: string]: {
+        [lane: string]: number;
+    };
+}
+interface IATRResult {
+    vehicles: IATRVehicles;
+    lane_counts: {
+        [lane: string]: number;
+    };
+    total_count: number;
+    detected_classes: {
+        [vehicleClass: string]: number;
+    };
+    study_type: "ATR";
+}
+interface IGroupedResult {
+    groupIndex: number;
+    startMinute: number;
+    endMinute: number;
+    label: string;
+    results: ITMCResult | IATRResult;
+    minuteCount: number;
+}
+interface IGroupedResponse {
+    success: boolean;
+    data: IGroupedResult[];
+    groupingMinutes: number;
+    video: {
+        uuid: string;
+        name: string;
+        videoType: string;
+        status: string;
+    };
+}
+export declare class VideoMinuteResultDAO implements IBaseDAO<IVideoMinuteResult> {
+    private knex;
+    private tableName;
+    getAll(page?: number, limit?: number): Promise<IDataPaginator<IVideoMinuteResult>>;
+    getById(id: number): Promise<IVideoMinuteResult | null>;
+    getByUuid(uuid: string): Promise<IVideoMinuteResult | null>;
+    create(data: IVideoMinuteResultInput): Promise<IVideoMinuteResult>;
+    update(id: number, data: IVideoMinuteResult): Promise<IVideoMinuteResult | null>;
+    delete(id: number): Promise<boolean>;
+    /**
+     * Get minute results for a specific video with optional time range filtering
+     */
+    getMinuteResultsForVideo(videoId: number, startMinute?: number, endMinute?: number, page?: number, limit?: number): Promise<IDataPaginator<IVideoMinuteResult>>;
+    /**
+     * Create batch of minute results for efficient bulk insertion
+     */
+    createBatch(videoId: number, minuteResults: IVideoMinuteResultInput[]): Promise<IVideoMinuteResult[]>;
+    /**
+     * Delete all minute results for a specific video
+     */
+    deleteByVideoId(videoId: number): Promise<boolean>;
+    /**
+     * Get the minute range for a video (min and max minute numbers)
+     */
+    getVideoMinuteRange(videoId: number): Promise<{
+        minMinute: number;
+        maxMinute: number;
+    } | null>;
+    /**
+     * Map database row to entity (snake_case -> camelCase)
+     */
+    private mapDbRowToEntity;
+    /**
+     * Map multiple database rows to entities
+     */
+    private mapDbRowsToEntities;
+    /**
+     * Map entity to database row (camelCase -> snake_case)
+     */
+    private mapEntityToDbRow;
+    /**
+     * Get minute results by video UUID (convenience method)
+     */
+    getMinuteResultsByVideoUuid(videoUuid: string, startMinute?: number, endMinute?: number, page?: number, limit?: number): Promise<IDataPaginator<IVideoMinuteResult>>;
+    /**
+     * Get grouped minute results by video UUID with time block aggregation
+     * @param videoUuid - The UUID of the video
+     * @param groupingMinutes - Number of minutes to group together (1, 5, 10, 15, 30, 60)
+     * @param startMinute - Optional start minute filter
+     * @param endMinute - Optional end minute filter
+     */
+    getGroupedMinuteResultsByVideoUuid(videoUuid: string, groupingMinutes?: number, startMinute?: number, endMinute?: number): Promise<IGroupedResponse>;
+    /**
+     * Aggregate minute results based on video type (TMC or ATR)
+     */
+    private aggregateMinuteResults;
+    /**
+     * Aggregate TMC (Turning Movement Count) results
+     */
+    private aggregateTMCResults;
+    /**
+     * Aggregate ATR (Automatic Traffic Recorder) results
+     */
+    private aggregateATRResults;
+    /**
+     * Generic aggregation for other video types
+     */
+    private aggregateGenericResults;
+    /**
+     * Recursively sum numeric values in nested objects
+     */
+    private sumNumericValues;
+    /**
+     * Deep clone a result structure, setting all numeric values to 0
+     */
+    private deepCloneStructure;
+    /**
+     * Normalize ATR vehicle class names to standard format for frontend compatibility
+     */
+    private normalizeATRVehicleClass;
+    /**
+     * Format time label for display (HH:MM:SS format)
+     */
+    private formatTimeLabel;
+}
+export default VideoMinuteResultDAO;