@trafficgroup/knex-rel 0.0.13 → 0.0.15

package/CLAUDE.md

@@ -0,0 +1,59 @@
+# 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
+
+### 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/user/user.dao.d.ts

@@ -5,6 +5,7 @@ export declare class UserDAO implements IBaseDAO<IUser> {
     create(item: IUser): Promise<IUser>;
     getById(id: number): Promise<IUser | null>;
     getByUuid(uuid: string): Promise<IUser | null>;
+    getByEmail(email: string): Promise<IUser | null>;
     update(id: number, item: Partial<IUser>): Promise<IUser | null>;
     delete(id: number): Promise<boolean>;
     getAll(page: number, limit: number): Promise<IDataPaginator<IUser>>;

package/dist/dao/user/user.dao.js

@@ -36,6 +36,12 @@ class UserDAO {
             return user || null;
         });
     }
+    getByEmail(email) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const user = yield this._knex("users").where({ email }).first();
+            return user || null;
+        });
+    }
     update(id, item) {
         return __awaiter(this, void 0, void 0, function* () {
             const [updatedUser] = yield this._knex("users").where({ id }).update(item).returning("*");

package/dist/dao/user/user.dao.js.map

@@ -1 +1 @@
-{"version":3,"file":"user.dao.js","sourceRoot":"","sources":["../../../src/dao/user/user.dao.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAGA,0EAA+C;AAE/C,MAAa,OAAO;IAApB;QACY,UAAK,GAAyB,wBAAW,CAAC,aAAa,EAAE,CAAC;IA4CtE,CAAC;IA1CS,MAAM,CAAC,IAAW;;YACpB,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC5E,OAAO,WAAW,CAAC;QACvB,CAAC;KAAA;IAEK,OAAO,CAAC,EAAU;;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC7D,OAAO,IAAI,IAAI,IAAI,CAAC;QACxB,CAAC;KAAA;IAEK,SAAS,CAAC,IAAY;;YACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC/D,OAAO,IAAI,IAAI,IAAI,CAAC;QACxB,CAAC;KAAA;IAEK,MAAM,CAAC,EAAU,EAAE,IAAoB;;YACzC,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC1F,OAAO,WAAW,IAAI,IAAI,CAAC;QAC/B,CAAC;KAAA;IAEK,MAAM,CAAC,EAAU;;YACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YAC7D,OAAO,MAAM,GAAG,CAAC,CAAC;QACtB,CAAC;KAAA;IAEK,MAAM,CAAC,IAAY,EAAE,KAAa;;YACpC,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;YAElC,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACpE,MAAM,UAAU,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAEpE,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,KAAK;gBACX,IAAI;gBACJ,KAAK;gBACL,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,UAAU;gBACV,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;aAC5C,CAAC;QACN,CAAC;KAAA;CACJ;AA7CD,0BA6CC"}
+{"version":3,"file":"user.dao.js","sourceRoot":"","sources":["../../../src/dao/user/user.dao.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAGA,0EAA+C;AAE/C,MAAa,OAAO;IAApB;QACY,UAAK,GAAyB,wBAAW,CAAC,aAAa,EAAE,CAAC;IAkDtE,CAAC;IAhDS,MAAM,CAAC,IAAW;;YACpB,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC5E,OAAO,WAAW,CAAC;QACvB,CAAC;KAAA;IAEK,OAAO,CAAC,EAAU;;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC7D,OAAO,IAAI,IAAI,IAAI,CAAC;QACxB,CAAC;KAAA;IAEK,SAAS,CAAC,IAAY;;YACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAC/D,OAAO,IAAI,IAAI,IAAI,CAAC;QACxB,CAAC;KAAA;IAGK,UAAU,CAAC,KAAa;;YAC1B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YAChE,OAAO,IAAI,IAAI,IAAI,CAAC;QACxB,CAAC;KAAA;IAEK,MAAM,CAAC,EAAU,EAAE,IAAoB;;YACzC,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC1F,OAAO,WAAW,IAAI,IAAI,CAAC;QAC/B,CAAC;KAAA;IAEK,MAAM,CAAC,EAAU;;YACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YAC7D,OAAO,MAAM,GAAG,CAAC,CAAC;QACtB,CAAC;KAAA;IAEK,MAAM,CAAC,IAAY,EAAE,KAAa;;YACpC,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;YAElC,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACpE,MAAM,UAAU,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAEpE,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,KAAK;gBACX,IAAI;gBACJ,KAAK;gBACL,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,UAAU;gBACV,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;aAC5C,CAAC;QACN,CAAC;KAAA;CACJ;AAnDD,0BAmDC"}

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

@@ -8,7 +8,9 @@ export interface IVideo {
     videoRate: number;
     videoType: 'TMC' | 'ATR' | 'JUNCTION' | 'ROUNDABOUT' | 'PATHWAY';
     metadata: Record<string, any>;
-    status: 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED';
+    status: 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'PENDING';
+    progress: number;
+    remainingTime: string;
     results: Record<string, any>;
     created_at: string;
     updated_at: string;

package/migrations/20250722210109_migration.ts

@@ -0,0 +1,60 @@
+import type { Knex } from "knex";
+
+
+export async function up(knex: Knex): Promise<void> {
+  // 1. Crear el tipo ENUM nativo
+  await knex.raw(`CREATE TYPE "video_status" AS ENUM ('QUEUED', 'PROCESSING', 'COMPLETED', 'FAILED', 'PENDING');`);
+
+  // 2. Normalizar los valores existentes
+  await knex.raw(`
+    UPDATE "video"
+    SET "status" = 'QUEUED'
+    WHERE "status" = 'QUEUE';
+  `);
+
+  // 3. Crear columna temporal del tipo ENUM
+  await knex.raw(`
+    ALTER TABLE "video"
+    ADD COLUMN "status_tmp" "video_status" DEFAULT 'PENDING';
+  `);
+
+  // 4. Copiar los valores de la columna original a la temporal
+  await knex.raw(`
+    UPDATE "video"
+    SET "status_tmp" = "status"::text::"video_status";
+  `);
+
+  // 5. Eliminar la columna original
+  await knex.raw(`
+    ALTER TABLE "video"
+    DROP COLUMN "status";
+  `);
+
+  // 6. Renombrar la columna temporal
+  await knex.raw(`
+    ALTER TABLE "video"
+    RENAME COLUMN "status_tmp" TO "status";
+  `);
+
+  // 7. Restaurar el default a 'PENDING'
+  await knex.raw(`
+    ALTER TABLE "video"
+    ALTER COLUMN "status" SET DEFAULT 'PENDING';
+  `);
+
+  // 8. Agregar columnas nuevas
+  await knex.schema.alterTable("video", (table) => {
+    table.integer("progress").notNullable().defaultTo(0);
+    table.string("remainingTime", 255).notNullable().defaultTo("0");
+  });
+}
+
+export async function down(knex: Knex): Promise<void> {
+  await knex.schema.alterTable("video", (table) => {
+    table.dropColumn("progress");
+    table.dropColumn("remainingTime");
+    table.specificType("status", "varchar(255)").notNullable().defaultTo("QUEUED").alter();
+  });
+  await knex.raw('DROP TYPE IF EXISTS "video_status";');
+}
+

package/migrations/20250722211019_migration.ts

@@ -0,0 +1,15 @@
+import type { Knex } from "knex";
+
+export async function up(knex: Knex): Promise<void> {
+  await knex.raw(`
+    ALTER TABLE "video"
+    ALTER COLUMN "status" SET DEFAULT 'PENDING';
+  `);
+}
+
+export async function down(knex: Knex): Promise<void> {
+  await knex.raw(`
+    ALTER TABLE "video"
+    ALTER COLUMN "status" SET DEFAULT 'QUEUED';
+  `);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trafficgroup/knex-rel",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Knex Module",
   "main": "dist/index.js",
   "scripts": {
@@ -27,7 +27,7 @@
   "devDependencies": {
     "@eslint/js": "^9.23.0",
     "@types/dotenv": "^6.1.1",
-    "@types/lodash": "^4.17.16",
+    "@types/lodash": "^4.17.20",
     "@types/node": "^22.13.13",
     "eslint": "^9.23.0",
     "globals": "^16.0.0",

package/src/dao/user/user.dao.ts

@@ -21,6 +21,12 @@ export class UserDAO implements IBaseDAO<IUser> {
         return user || null;
     }
 
+
+    async getByEmail(email: string): Promise<IUser | null> {
+        const user = await this._knex("users").where({ email }).first();
+        return user || null;
+    }
+
     async update(id: number, item: Partial<IUser>): Promise<IUser | null> {
         const [updatedUser] = await this._knex("users").where({ id }).update(item).returning("*");
         return updatedUser || null;

package/src/interfaces/video/video.interfaces.ts

@@ -9,7 +9,9 @@ export interface IVideo {
     videoRate: number;
     videoType: 'TMC' | 'ATR' | 'JUNCTION' | 'ROUNDABOUT' | 'PATHWAY';
     metadata: Record<string, any>;
-    status: 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED';
+    status: 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'PENDING';
+    progress: number;
+    remainingTime: string;
     results: Record<string, any>;
     created_at: string;
     updated_at: string;