@trafficgroup/knex-rel 0.1.7 → 0.1.8

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { AuthDAO } from "./dao/auth/auth.dao";
+export { BatchDAO } from "./dao/batch/batch.dao";
 export { CameraDAO } from "./dao/camera/camera.dao";
 export { ChatDAO } from "./dao/chat/chat.dao";
 export { FolderDAO } from "./dao/folder/folder.dao";
@@ -11,6 +12,7 @@ export { VideoDAO } from "./dao/video/video.dao";
 export { VideoMinuteResultDAO } from "./dao/VideoMinuteResultDAO";
 export { IDataPaginator } from "./d.types";
 export { IAuth } from "./interfaces/auth/auth.interfaces";
+export { IBatch } from "./interfaces/batch/batch.interfaces";
 export { ICamera } from "./interfaces/camera/camera.interfaces";
 export { IChat, IChatCreate, IChatUpdate, } from "./interfaces/chat/chat.interfaces";
 export { IFolder } from "./interfaces/folder/folder.interfaces";
@@ -19,7 +21,8 @@ export { IReportConfiguration, IReportConfigurationData, IReportConfigurationInp
 export { IStudy } from "./interfaces/study/study.interfaces";
 export { IUser } from "./interfaces/user/user.interfaces";
 export { IUserPushNotificationToken } from "./interfaces/user-push-notification-token/user-push-notification-token.interfaces";
-export { IVideo } from "./interfaces/video/video.interfaces";
+export { IVideo, ITrimPeriod } from "./interfaces/video/video.interfaces";
 export { IVideoMinuteResult, IVideoMinuteResultInput, IVideoMinuteBatch, } from "./entities/VideoMinuteResult";
+export type { IStudyTimeGroupResult, IGroupedStudyResponse, IGroupedResponse, IGroupedResult, ITMCResult, IATRResult, } from "./dao/VideoMinuteResultDAO";
 import KnexManager from "./KnexConnection";
 export { KnexManager };

package/dist/index.js

@@ -3,10 +3,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KnexManager = exports.VideoMinuteResultDAO = exports.VideoDAO = exports.UserPushNotificationTokenDAO = exports.UserDAO = exports.StudyDAO = exports.ReportConfigurationDAO = exports.MessageDAO = exports.FolderDAO = exports.ChatDAO = exports.CameraDAO = exports.AuthDAO = void 0;
+exports.KnexManager = exports.VideoMinuteResultDAO = exports.VideoDAO = exports.UserPushNotificationTokenDAO = exports.UserDAO = exports.StudyDAO = exports.ReportConfigurationDAO = exports.MessageDAO = exports.FolderDAO = exports.ChatDAO = exports.CameraDAO = exports.BatchDAO = exports.AuthDAO = void 0;
 // DAOs
 var auth_dao_1 = require("./dao/auth/auth.dao");
 Object.defineProperty(exports, "AuthDAO", { enumerable: true, get: function () { return auth_dao_1.AuthDAO; } });
+var batch_dao_1 = require("./dao/batch/batch.dao");
+Object.defineProperty(exports, "BatchDAO", { enumerable: true, get: function () { return batch_dao_1.BatchDAO; } });
 var camera_dao_1 = require("./dao/camera/camera.dao");
 Object.defineProperty(exports, "CameraDAO", { enumerable: true, get: function () { return camera_dao_1.CameraDAO; } });
 var chat_dao_1 = require("./dao/chat/chat.dao");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO;AACP,gDAA8C;AAArC,mGAAA,OAAO,OAAA;AAChB,sDAAoD;AAA3C,uGAAA,SAAS,OAAA;AAClB,gDAA8C;AAArC,mGAAA,OAAO,OAAA;AAChB,sDAAoD;AAA3C,uGAAA,SAAS,OAAA;AAClB,yDAAuD;AAA9C,yGAAA,UAAU,OAAA;AACnB,gGAA6F;AAApF,kIAAA,sBAAsB,OAAA;AAC/B,mDAAiD;AAAxC,qGAAA,QAAQ,OAAA;AACjB,gDAA8C;AAArC,mGAAA,OAAO,OAAA;AAChB,wHAAmH;AAA1G,gJAAA,4BAA4B,OAAA;AACrC,mDAAiD;AAAxC,qGAAA,QAAQ,OAAA;AACjB,mEAAkE;AAAzD,4HAAA,oBAAoB,OAAA;AAkC7B,sEAA2C;AAClC,sBADF,wBAAW,CACE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO;AACP,gDAA8C;AAArC,mGAAA,OAAO,OAAA;AAChB,mDAAiD;AAAxC,qGAAA,QAAQ,OAAA;AACjB,sDAAoD;AAA3C,uGAAA,SAAS,OAAA;AAClB,gDAA8C;AAArC,mGAAA,OAAO,OAAA;AAChB,sDAAoD;AAA3C,uGAAA,SAAS,OAAA;AAClB,yDAAuD;AAA9C,yGAAA,UAAU,OAAA;AACnB,gGAA6F;AAApF,kIAAA,sBAAsB,OAAA;AAC/B,mDAAiD;AAAxC,qGAAA,QAAQ,OAAA;AACjB,gDAA8C;AAArC,mGAAA,OAAO,OAAA;AAChB,wHAAmH;AAA1G,gJAAA,4BAA4B,OAAA;AACrC,mDAAiD;AAAxC,qGAAA,QAAQ,OAAA;AACjB,mEAAkE;AAAzD,4HAAA,oBAAoB,OAAA;AA2C7B,sEAA2C;AAClC,sBADF,wBAAW,CACE"}

package/dist/interfaces/batch/batch.interfaces.d.ts

@@ -0,0 +1,13 @@
+import type { IFolder } from "../folder/folder.interfaces";
+export interface IBatch {
+    id: number;
+    uuid: string;
+    folderId: number;
+    status: "PENDING" | "IN_PROGRESS" | "COMPLETED" | "FAILED";
+    totalVideos: number;
+    completedVideos: number;
+    failedVideos: number;
+    created_at: string;
+    updated_at: string;
+    folder?: IFolder;
+}

package/dist/interfaces/batch/batch.interfaces.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=batch.interfaces.js.map

package/dist/interfaces/batch/batch.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.interfaces.js","sourceRoot":"","sources":["../../../src/interfaces/batch/batch.interfaces.ts"],"names":[],"mappings":""}

package/dist/interfaces/video/video.interfaces.d.ts

@@ -1,4 +1,8 @@
 import type { IFolder } from "../folder/folder.interfaces";
+export interface ITrimPeriod {
+    startTime: string;
+    endTime: string;
+}
 export interface IVideo {
     id: number;
     uuid: string;
@@ -20,6 +24,10 @@ export interface IVideo {
     hlsPlaylist: string | null;
     videoSizeMB: number | null;
     streamingMetadata: Record<string, any> | null;
+    recordingStartedAt?: Date;
+    trimEnabled?: boolean;
+    trimPeriods?: ITrimPeriod[] | null;
+    batchId?: number | null;
     created_at: string;
     updated_at: string;
     folder?: IFolder;

package/migrations/20251020225758_migration.ts

@@ -0,0 +1,135 @@
+import type { Knex } from "knex";
+
+/**
+ * Migration: Add Recording Time, Video Trimming, and Batch Upload Features
+ *
+ * This migration implements three major features:
+ * 1. Recording Start Time - REQUIRED field for all videos (TIMESTAMPTZ in UTC)
+ * 2. Video Trimming - Optional datetime-based trimming with frame-skipping
+ * 3. Batch Upload - Up to 50 videos in all-or-nothing transaction
+ *
+ * FK Pattern: video_batch table uses id (INTEGER) for FKs, uuid (UUID) for external API
+ */
+export async function up(knex: Knex): Promise<void> {
+  // Step 1: Create video_batch table with proper id/uuid pattern
+  await knex.schema.createTable("video_batch", (table) => {
+    table
+      .increments("id")
+      .primary()
+      .comment("Primary key for internal foreign key relationships");
+
+    table
+      .uuid("uuid")
+      .notNullable()
+      .unique()
+      .defaultTo(knex.raw("uuid_generate_v4()"))
+      .comment("UUID for external API communication");
+
+    table
+      .integer("folderId")
+      .unsigned()
+      .notNullable()
+      .references("id")
+      .inTable("folders")
+      .onDelete("CASCADE")
+      .comment("Foreign key to folders table");
+
+    table
+      .enu("status", ["PENDING", "IN_PROGRESS", "COMPLETED", "FAILED"])
+      .notNullable()
+      .defaultTo("PENDING")
+      .comment("Status of the batch upload");
+
+    table
+      .integer("totalVideos")
+      .notNullable()
+      .defaultTo(0)
+      .comment("Total number of videos in batch");
+
+    table
+      .integer("completedVideos")
+      .notNullable()
+      .defaultTo(0)
+      .comment("Number of successfully created videos");
+
+    table
+      .integer("failedVideos")
+      .notNullable()
+      .defaultTo(0)
+      .comment("Number of failed videos");
+
+    table.timestamps(true, true);
+  });
+
+  // Step 2: Add recording time, trimming, and batch columns to video table
+  await knex.schema.alterTable("video", (table) => {
+    table
+      .timestamp("recordingStartedAt", { useTz: true })
+      .nullable()
+      .comment("Recording start time in UTC - null for backward compatibility");
+
+    table
+      .boolean("trimEnabled")
+      .notNullable()
+      .defaultTo(false)
+      .comment("Whether video trimming is enabled");
+
+    table
+      .jsonb("trimPeriods")
+      .nullable()
+      .comment(
+        "Array of trim periods with startTime and endTime in ISO 8601 format",
+      );
+
+    table
+      .integer("batchId")
+      .unsigned()
+      .nullable()
+      .references("id")
+      .inTable("video_batch")
+      .withKeyName("fk_video_batch")
+      .onDelete("SET NULL")
+      .comment("Foreign key to video_batch table (numerical ID, NOT UUID)");
+  });
+
+  // Step 3: Create indices for performance optimization
+
+  // Index for chronological queries by folder and recording time
+  await knex.raw(`
+    CREATE INDEX idx_videos_folder_recording
+    ON video("folderId", "recordingStartedAt")
+    WHERE "recordingStartedAt" IS NOT NULL
+  `);
+
+  // Index for batch operations
+  await knex.raw(`
+    CREATE INDEX idx_videos_batch
+    ON video("batchId")
+    WHERE "batchId" IS NOT NULL
+  `);
+
+  // Index for trimming filter
+  await knex.raw(`
+    CREATE INDEX idx_videos_trimming
+    ON video("trimEnabled")
+    WHERE "trimEnabled" = true
+  `);
+}
+
+export async function down(knex: Knex): Promise<void> {
+  // Drop indices first
+  await knex.raw(`DROP INDEX IF EXISTS idx_videos_folder_recording`);
+  await knex.raw(`DROP INDEX IF EXISTS idx_videos_batch`);
+  await knex.raw(`DROP INDEX IF EXISTS idx_videos_trimming`);
+
+  // Drop columns from video table
+  await knex.schema.alterTable("video", (table) => {
+    table.dropColumn("recordingStartedAt");
+    table.dropColumn("trimEnabled");
+    table.dropColumn("trimPeriods");
+    table.dropColumn("batchId");
+  });
+
+  // Drop video_batch table
+  await knex.schema.dropTableIfExists("video_batch");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trafficgroup/knex-rel",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "Knex Module",
   "main": "dist/index.js",
   "scripts": {