@friggframework/core 2.0.0--canary.461.5767fa4.0 → 2.0.0--canary.461.3d6d8ad.0

package/database/use-cases/check-migration-status-use-case.js

@@ -0,0 +1,81 @@
+/**
+ * Check Migration Status Use Case
+ * 
+ * Domain logic for checking if database has pending migrations.
+ * Does NOT trigger migrations, just reports status.
+ * 
+ * Architecture: Hexagonal/Clean
+ * - Use Case (Domain Layer)
+ * - Depends on prismaRunner (Infrastructure abstraction)
+ * - Called by Router (Adapter Layer)
+ */
+
+class ValidationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ValidationError';
+    }
+}
+
+class CheckMigrationStatusUseCase {
+    /**
+     * @param {Object} dependencies
+     * @param {Object} dependencies.prismaRunner - Prisma runner utility
+     */
+    constructor({ prismaRunner }) {
+        if (!prismaRunner) {
+            throw new Error('prismaRunner dependency is required');
+        }
+        this.prismaRunner = prismaRunner;
+    }
+
+    /**
+     * Execute check migration status
+     * 
+     * @param {string} dbType - Database type (postgresql or mongodb)
+     * @param {string} stage - Deployment stage (default: 'production')
+     * @returns {Promise<Object>} Migration status
+     */
+    async execute(dbType, stage = 'production') {
+        // Validate inputs
+        if (!dbType) {
+            throw new ValidationError('dbType is required');
+        }
+
+        if (!['postgresql', 'mongodb'].includes(dbType)) {
+            throw new ValidationError('dbType must be postgresql or mongodb');
+        }
+
+        console.log(`Checking migration status for ${dbType} in ${stage}`);
+
+        // Check database state using Prisma
+        const state = await this.prismaRunner.checkDatabaseState(dbType);
+
+        // Build response
+        const response = {
+            upToDate: state.upToDate,
+            pendingMigrations: state.pendingMigrations || 0,
+            dbType,
+            stage,
+        };
+
+        // Add error if present
+        if (state.error) {
+            response.error = state.error;
+            response.recommendation = 'Run POST /db-migrate to initialize database';
+        }
+
+        // Add recommendation if migrations pending
+        if (!state.upToDate && state.pendingMigrations > 0) {
+            response.recommendation = `Run POST /db-migrate to apply ${state.pendingMigrations} pending migration(s)`;
+        }
+
+        return response;
+    }
+}
+
+module.exports = {
+    CheckMigrationStatusUseCase,
+    ValidationError,
+};
+

package/handlers/routers/db-migration.js

@@ -4,6 +4,7 @@
  * HTTP API for triggering and monitoring database migrations.
  *
  * Endpoints:
+ * - GET /db-migrate/status - Check if migrations are pending
  * - POST /db-migrate - Trigger async migration (queues job)
  * - GET /db-migrate/:processId - Check migration status
  *
@@ -27,6 +28,11 @@ const {
     ValidationError: GetValidationError,
     NotFoundError,
 } = require('../../database/use-cases/get-migration-status-use-case');
+const {
+    CheckMigrationStatusUseCase,
+    ValidationError: CheckValidationError,
+} = require('../../database/use-cases/check-migration-status-use-case');
+const prismaRunner = require('../../database/utils/prisma-runner');
 
 const router = Router();
 
@@ -40,6 +46,7 @@ const triggerMigrationUseCase = new TriggerDatabaseMigrationUseCase({
     // Note: QueuerUtil is used directly in the use case (static utility)
 });
 const getStatusUseCase = new GetMigrationStatusUseCase({ migrationStatusRepository });
+const checkMigrationStatusUseCase = new CheckMigrationStatusUseCase({ prismaRunner });
 
 /**
  * Admin API key validation middleware
@@ -118,6 +125,51 @@ router.post(
     })
 );
 
+/**
+ * GET /db-migrate/status
+ *
+ * Check if database has pending migrations
+ * 
+ * Query params:
+ * - stage: string (optional, defaults to STAGE env var or 'production')
+ *
+ * Response (200 OK):
+ * {
+ *   upToDate: boolean,
+ *   pendingMigrations: number,
+ *   dbType: 'postgresql',
+ *   stage: string,
+ *   recommendation?: string (if migrations pending),
+ *   error?: string (if database check failed)
+ * }
+ */
+router.get(
+    '/db-migrate/status',
+    catchAsyncError(async (req, res) => {
+        const stage = req.query.stage || process.env.STAGE || 'production';
+        const dbType = process.env.DB_TYPE || 'postgresql'; // Hardcoded for PostgreSQL migrations
+
+        console.log(`Checking migration status: dbType=${dbType}, stage=${stage}`);
+
+        try {
+            const status = await checkMigrationStatusUseCase.execute(dbType, stage);
+
+            res.status(200).json(status);
+        } catch (error) {
+            // Handle validation errors (400 Bad Request)
+            if (error instanceof CheckValidationError) {
+                return res.status(400).json({
+                    success: false,
+                    error: error.message,
+                });
+            }
+
+            // Re-throw other errors for global error handler
+            throw error;
+        }
+    })
+);
+
 /**
  * GET /db-migrate/:migrationId
  *

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@friggframework/core",
     "prettier": "@friggframework/prettier-config",
-    "version": "2.0.0--canary.461.5767fa4.0",
+    "version": "2.0.0--canary.461.3d6d8ad.0",
     "dependencies": {
         "@aws-sdk/client-apigatewaymanagementapi": "^3.588.0",
         "@aws-sdk/client-kms": "^3.588.0",
@@ -37,9 +37,9 @@
         }
     },
     "devDependencies": {
-        "@friggframework/eslint-config": "2.0.0--canary.461.5767fa4.0",
-        "@friggframework/prettier-config": "2.0.0--canary.461.5767fa4.0",
-        "@friggframework/test": "2.0.0--canary.461.5767fa4.0",
+        "@friggframework/eslint-config": "2.0.0--canary.461.3d6d8ad.0",
+        "@friggframework/prettier-config": "2.0.0--canary.461.3d6d8ad.0",
+        "@friggframework/test": "2.0.0--canary.461.3d6d8ad.0",
         "@prisma/client": "^6.17.0",
         "@types/lodash": "4.17.15",
         "@typescript-eslint/eslint-plugin": "^8.0.0",
@@ -79,5 +79,5 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "5767fa41c5e27a098d51bf4edff785f87de1d6bf"
+    "gitHead": "3d6d8ad065c2530fee34dcda5ee304979c718a65"
 }