npm - @manojkmfsi/monodog - Versions diffs - 1.0.24 → 1.1.0 - Mend

@manojkmfsi/monodog 1.0.24 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (48) hide show

package/.turbo/turbo-build.log +1 -1
package/CHANGELOG.md +12 -0
package/dist/config/swagger-config.js +345 -0
package/dist/constants/index.js +26 -0
package/dist/constants/middleware.js +71 -0
package/dist/constants/port.js +20 -0
package/dist/constants/security.js +67 -0
package/dist/middleware/dashboard-startup.js +20 -21
package/dist/middleware/error-handler.js +3 -10
package/dist/middleware/index.js +4 -2
package/dist/middleware/logger.js +63 -0
package/dist/middleware/security.js +11 -10
package/dist/middleware/server-startup.js +32 -25
package/dist/middleware/swagger-middleware.js +54 -0
package/dist/routes/health-routes.js +1 -1
package/dist/routes/package-routes.js +1 -1
package/dist/serve.js +15 -2
package/dist/services/health-service.js +84 -64
package/dist/services/package-service.js +23 -1
package/monodog-dashboard/dist/assets/{index-746f6c13.js → index-45e19f29.js} +1 -1
package/monodog-dashboard/dist/index.html +1 -1
package/package.json +14 -4
package/prisma/schema/commit.prisma +11 -0
package/prisma/schema/dependency-info.prisma +12 -0
package/prisma/schema/health-status.prisma +14 -0
package/prisma/schema/package-health.prisma +15 -0
package/prisma/schema/package.prisma +21 -0
package/prisma/schema/schema.prisma +15 -0
package/src/config/swagger-config.ts +344 -0
package/src/constants/index.ts +13 -0
package/src/constants/middleware.ts +83 -0
package/src/constants/port.ts +20 -0
package/src/constants/security.ts +78 -0
package/src/middleware/dashboard-startup.ts +35 -24
package/src/middleware/error-handler.ts +2 -15
package/src/middleware/index.ts +3 -1
package/src/middleware/logger.ts +58 -0
package/src/middleware/security.ts +19 -10
package/src/middleware/server-startup.ts +43 -30
package/src/middleware/swagger-middleware.ts +57 -0
package/src/routes/health-routes.ts +1 -1
package/src/routes/package-routes.ts +1 -1
package/src/serve.ts +19 -3
package/src/services/health-service.ts +103 -79
package/src/services/package-service.ts +27 -1
package/src/types/swagger-jsdoc.d.ts +15 -0
package/prisma/schema.prisma +0 -116
/package/prisma/migrations/{20251219074511_create_unique_composite_key_for_commits → 20251219090102_composite_key_for_table_commits}/migration.sql +0 -0

package/monodog-dashboard/dist/index.html CHANGED Viewed

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>MonoDog Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-746f6c13.js"></script>
+    <script type="module" crossorigin src="/assets/index-45e19f29.js"></script>
     <link rel="stylesheet" href="/assets/index-504dc418.css">
   </head>
   <body class="bg-gray-100 text-gray-900">

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@manojkmfsi/monodog",
-  "version": "1.0.24",
+  "version": "1.1.0",
   "description": "App for monodog monorepo",
   "license": "MIT",
   "bin": {
@@ -14,7 +14,9 @@
     "helmet": "^7.1.0",
     "init": "^0.1.2",
     "js-yaml": "^4.1.0",
-    "prisma": "^5.22.0"
+    "prisma": "^5.22.0",
+    "swagger-jsdoc": "^6.2.8",
+    "swagger-ui-express": "^5.0.1"
   },
   "devDependencies": {
     "@types/body-parser": "^1.19.6",
@@ -22,25 +24,33 @@
     "@types/express": "^4.17.25",
     "@types/jest": "^29.5.14",
     "@types/js-yaml": "^4.0.9",
+    "@types/morgan": "^1.9.10",
     "@types/node": "^20.19.27",
+    "@types/swagger-ui-express": "^4.1.6",
     "cross-env": "^10.1.0",
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^30.2.0",
+    "morgan": "^1.10.1",
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
+  "prisma": {
+    "schema": "./prisma/schema"
+  },
   "scripts": {
-    "dev": "DATABASE_URL=$(npm run db:url --silent 2>/dev/null | tr -d '\\n') tsx watch src/serve.js",
+    "dev": "DATABASE_URL=$(npm run db:url --silent 2>/dev/null | tr -d '\\n') tsx watch src/serve.ts --dev --debug",
     "serve": "DATABASE_URL=$(npm run db:url --silent 2>/dev/null | tr -d '\\n') tsx dist/serve.js",
     "build": "rm -rf dist && tsc",
-    "test:coverage": "jest --coverage",
+    "test:coverage": "jest --coverage --silent",
     "prestart": "npm run build",
     "clean": "rm -rf dist node_modules/.cache",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "db:url": "node dist/get-db-url.js",
+    "schema:format": "DATABASE_URL=$(npm run db:url --silent 2>/dev/null | tr -d '\\n') prisma format",
+    "schema:validate": "DATABASE_URL=$(npm run db:url --silent 2>/dev/null | tr -d '\\n') prisma validate",
     "generate": "DATABASE_URL=$(npm run db:url --silent 2>/dev/null | tr -d '\\n') prisma generate",
     "migrate": "DATABASE_URL=$(npm run db:url --silent 2>/dev/null | tr -d '\\n') prisma migrate dev",
     "migrate:reset": "DATABASE_URL=$(npm run db:url --silent 2>/dev/null | tr -d '\\n') prisma migrate reset --force"

package/prisma/schema/commit.prisma ADDED Viewed

@@ -0,0 +1,11 @@
+model Commit {
+  hash        String
+  message     String
+  author      String
+  date        DateTime?
+  type        String
+  packageName String
+  package     Package   @relation(fields: [packageName], references: [name], onDelete: Cascade)
+  @@unique([hash, packageName])
+}

package/prisma/schema/dependency-info.prisma ADDED Viewed

@@ -0,0 +1,12 @@
+model DependencyInfo {
+  name        String
+  packageName String
+  version     String
+  type        String  @default("")
+  status      String  @default("")
+  latest      String?
+  outdated    Boolean @default(false)
+  package     Package @relation(fields: [packageName], references: [name], onDelete: Cascade)
+  @@unique([name, packageName]) // Composite unique constraint
+}

package/prisma/schema/health-status.prisma ADDED Viewed

@@ -0,0 +1,14 @@
+model HealthStatus {
+  id           Int      @id @default(autoincrement())
+  packageName  String   @unique
+  overallScore Float // Overall health score (0-100)
+  buildStatus  String // e.g., "passing", "failing", "unknown"
+  testCoverage Float // Test coverage percentage (0-100)
+  lintStatus   String // e.g., "passing", "warning", "failing"
+  security     String // e.g., "secure", "vulnerabilities", "unknown"
+  dependencies String // e.g., "up-to-date", "outdated", "vulnerable"
+  createdAt    DateTime @default(now())
+  updatedAt    DateTime @updatedAt
+  @@map("health_status")
+}

package/prisma/schema/package-health.prisma ADDED Viewed

@@ -0,0 +1,15 @@
+model PackageHealth {
+  id                  Int      @id @default(autoincrement())
+  packageName         String   @unique
+  packageOverallScore Float
+  packageBuildStatus  String
+  packageTestCoverage Float?
+  packageLintStatus   String
+  packageSecurity     String // Changed from securityAudit to packageSecurity
+  packageDependencies String // Changed from dependencies to packageDependencies
+  createdAt           DateTime @default(now())
+  updatedAt           DateTime @updatedAt
+  package             Package  @relation(fields: [packageName], references: [name], onDelete: Cascade)
+  @@map("package_health")
+}

package/prisma/schema/package.prisma ADDED Viewed

@@ -0,0 +1,21 @@
+model Package {
+  // Primary Key and Identity Field (using the package name as the unique ID): Example: '@monodog/dashboard'
+  name             String           @id @unique
+  version          String
+  type             String // e.g., 'app', 'package'
+  createdAt        DateTime         @default(now())
+  lastUpdated      DateTime         @default(now())
+  dependencies     String?
+  maintainers      String
+  path             String // The relative path in the file system, e.g., 'packages/monoapp'
+  description      String
+  license          String
+  repository       String?
+  scripts          String?
+  status           String           @default("")
+  devDependencies  String?
+  peerDependencies String?
+  dependenciesInfo DependencyInfo[]
+  commits          Commit[]
+  packageHealth    PackageHealth?
+}

package/prisma/schema/schema.prisma ADDED Viewed

@@ -0,0 +1,15 @@
+// This is your Prisma schema file,
+// learn more about it in the docs: https://pris.ly/d/prisma-schema
+// Looking for ways to speed up your queries, or scale easily with your serverless or edge functions?
+// Try Prisma Accelerate: https://pris.ly/cli/accelerate-init
+generator client {
+  provider        = "prisma-client-js"
+  previewFeatures = ["prismaSchemaFolder"]
+}
+datasource db {
+  provider = "sqlite"
+  url      = env("DATABASE_URL")
+}

package/src/config/swagger-config.ts ADDED Viewed

@@ -0,0 +1,344 @@
+/**
+ * Swagger API Documentation Configuration
+ * Defines OpenAPI specification for MonoDog API
+ */
+import { appConfig } from "../config-loader";
+export const swaggerDefinition = {
+  openapi: '3.0.0',
+  info: {
+    title: 'MonoDog API',
+    version: '1.0.0',
+    description: 'Monorepo Analytics and Health Dashboard API',
+    contact: {
+      name: 'MonoDog Team',
+      url: 'https://github.com/mindfiredigital/monodog',
+    },
+    license: {
+      name: 'MIT',
+      url: 'https://opensource.org/licenses/MIT',
+    },
+  },
+  servers: [
+    {
+      url: `http://${appConfig.server.host}:${appConfig.server.port}/api`,
+      description: 'Development server',
+    },
+  ],
+  paths: {
+    '/packages': {
+      get: {
+        tags: ['Packages'],
+        summary: 'Get all packages',
+        operationId: 'getPackages',
+        responses: {
+          '200': {
+            description: 'List of packages',
+            content: {
+              'application/json': {
+                schema: { type: 'array', items: { $ref: '#/components/schemas/Package' } },
+              },
+            },
+          },
+          '500': { description: 'Internal server error' },
+        },
+      },
+    },
+    '/packages/{name}': {
+      get: {
+        tags: ['Packages'],
+        summary: 'Get package by name',
+        operationId: 'getPackageByName',
+        parameters: [{ name: 'name', in: 'path', required: true, schema: { type: 'string' } }],
+        responses: {
+          '200': {
+            description: 'Package details',
+            content: {
+              'application/json': {
+                schema: { $ref: '#/components/schemas/Package' },
+              },
+            },
+          },
+          '404': { description: 'Package not found' },
+        },
+      },
+    },
+    '/packages/refresh': {
+      post: {
+        tags: ['Packages'],
+        summary: 'Refresh packages',
+        operationId: 'refreshPackages',
+        responses: {
+          '200': { description: 'Packages refreshed successfully' },
+        },
+      },
+    },
+    '/packages/update-config': {
+      put: {
+        tags: ['Packages'],
+        summary: 'Update package configuration',
+        operationId: 'updatePackageConfig',
+        requestBody: {
+          required: true,
+          content: {
+            'application/json': {
+              schema: { $ref: '#/components/schemas/Package' },
+            },
+          },
+        },
+        responses: {
+          '200': { description: 'Package configuration updated successfully' },
+          '400': { description: 'Invalid request' },
+          '404': { description: 'Package not found' },
+        },
+      },
+    },
+    '/health/packages': {
+      get: {
+        tags: ['Health'],
+        summary: 'Get packages health status',
+        operationId: 'getPackagesHealth',
+        responses: {
+          '200': {
+            description: 'Health status of all packages',
+            content: {
+              'application/json': {
+                schema: { type: 'array', items: { $ref: '#/components/schemas/PackageHealth' } },
+              },
+            },
+          },
+        },
+      },
+    },
+    '/health/refresh': {
+      post: {
+        tags: ['Health'],
+        summary: 'Refresh health status',
+        operationId: 'refreshHealth',
+        responses: {
+          '200': { description: 'Health status refreshed successfully' },
+        },
+      },
+    },
+    '/commits/{packagePath}': {
+      get: {
+        tags: ['Commits'],
+        summary: 'Get commits for a package',
+        operationId: 'getCommits',
+        parameters: [{ name: 'packagePath', in: 'path', required: true, schema: { type: 'string' } }],
+        responses: {
+          '200': {
+            description: 'List of commits',
+            content: {
+              'application/json': {
+                schema: { type: 'array', items: { $ref: '#/components/schemas/Commit' } },
+              },
+            },
+          },
+        },
+      },
+    },
+    '/config/files': {
+      get: {
+        tags: ['Configuration'],
+        summary: 'Get configuration files',
+        operationId: 'getConfigFiles',
+        responses: {
+          '200': {
+            description: 'List of configuration files',
+            content: {
+              'application/json': {
+                schema: { type: 'array', items: { $ref: '#/components/schemas/ConfigFile' } },
+              },
+            },
+          },
+        },
+      },
+    },
+    '/config/files/{id}': {
+      put: {
+        tags: ['Configuration'],
+        summary: 'Update configuration file',
+        operationId: 'updateConfigFile',
+        parameters: [{ name: 'id', in: 'path', required: true, schema: { type: 'string' } }],
+        requestBody: {
+          required: true,
+          content: {
+            'application/json': {
+              schema: { $ref: '#/components/schemas/ConfigFile' },
+            },
+          },
+        },
+        responses: {
+          '200': { description: 'Configuration file updated successfully' },
+          '400': { description: 'Invalid request' },
+          '404': { description: 'Configuration file not found' },
+        },
+      },
+    },
+  },
+  tags: [
+    {
+      name: 'Packages',
+      description: 'Package management and analysis endpoints',
+    },
+    {
+      name: 'Health',
+      description: 'Health monitoring and status endpoints',
+    },
+    {
+      name: 'Commits',
+      description: 'Git commit history and analysis endpoints',
+    },
+    {
+      name: 'Configuration',
+      description: 'Configuration file management endpoints',
+    },
+  ],
+  components: {
+    schemas: {
+      Package: {
+        type: 'object',
+        properties: {
+          name: {
+            type: 'string',
+            description: 'Package name',
+          },
+          path: {
+            type: 'string',
+            description: 'Package path in monorepo',
+          },
+          version: {
+            type: 'string',
+            description: 'Package version',
+          },
+          size: {
+            type: 'number',
+            description: 'Package size in bytes',
+          },
+          dependencies: {
+            type: 'array',
+            items: {
+              type: 'string',
+            },
+            description: 'List of package dependencies',
+          },
+        },
+      },
+      PackageHealth: {
+        type: 'object',
+        properties: {
+          packageName: {
+            type: 'string',
+            description: 'Name of the package',
+          },
+          healthScore: {
+            type: 'number',
+            description: 'Health score (0-100)',
+            minimum: 0,
+            maximum: 100,
+          },
+          lintStatus: {
+            type: 'string',
+            enum: ['pass', 'warning', 'fail'],
+            description: 'Linting status',
+          },
+          buildStatus: {
+            type: 'string',
+            enum: ['success', 'failed', 'pending'],
+            description: 'Build status',
+          },
+          securityStatus: {
+            type: 'string',
+            enum: ['secure', 'warning', 'vulnerable'],
+            description: 'Security status',
+          },
+          testCoverage: {
+            type: 'number',
+            description: 'Test coverage percentage',
+          },
+        },
+      },
+      Commit: {
+        type: 'object',
+        properties: {
+          hash: {
+            type: 'string',
+            description: 'Commit hash',
+          },
+          author: {
+            type: 'string',
+            description: 'Commit author',
+          },
+          message: {
+            type: 'string',
+            description: 'Commit message',
+          },
+          date: {
+            type: 'string',
+            format: 'date-time',
+            description: 'Commit date',
+          },
+          filesChanged: {
+            type: 'number',
+            description: 'Number of files changed',
+          },
+        },
+      },
+      ConfigFile: {
+        type: 'object',
+        properties: {
+          id: {
+            type: 'string',
+            description: 'Configuration file ID',
+          },
+          name: {
+            type: 'string',
+            description: 'Configuration file name',
+          },
+          path: {
+            type: 'string',
+            description: 'Configuration file path',
+          },
+          content: {
+            type: 'string',
+            description: 'Configuration file content',
+          },
+        },
+      },
+      Error: {
+        type: 'object',
+        properties: {
+          error: {
+            type: 'string',
+            description: 'Error message',
+          },
+          message: {
+            type: 'string',
+            description: 'Detailed error message',
+          },
+          code: {
+            type: 'string',
+            description: 'Error code',
+          },
+        },
+      },
+    },
+    responses: {
+      UnauthorizedError: {
+        description: 'Unauthorized access',
+      },
+      NotFoundError: {
+        description: 'Resource not found',
+      },
+      InternalServerError: {
+        description: 'Internal server error',
+      },
+    },
+  },
+};
+export const swaggerOptions = {
+  definition: swaggerDefinition,
+  apis: [], // Using only definition, no JSDoc file scanning
+};

package/src/constants/index.ts ADDED Viewed

@@ -0,0 +1,13 @@
+/**
+ * Constants Index
+ * Centralized export of all application constants
+ */
+// Port constants
+export * from './port';
+// Security constants
+export * from './security';
+// Middleware constants
+export * from './middleware';

package/src/constants/middleware.ts ADDED Viewed

@@ -0,0 +1,83 @@
+/**
+ * Middleware Constants
+ * Defines constants used across middleware modules
+ */
+/**
+ * HTTP status code for internal server error
+ */
+export const HTTP_STATUS_INTERNAL_SERVER_ERROR = 500;
+/**
+ * HTTP status code for not found
+ */
+export const HTTP_STATUS_NOT_FOUND = 404;
+/**
+ * HTTP status code for bad request
+ */
+export const HTTP_STATUS_BAD_REQUEST = 400;
+/**
+ * Error message for port already in use
+ */
+export const ERROR_PORT_IN_USE = (port: number): string =>
+  `Port ${port} is already in use. Please specify a different port.`;
+/**
+ * Error message for permission denied
+ */
+export const ERROR_PERMISSION_DENIED = (port: number): string =>
+  `Permission denied to listen on port ${port}. Use a port above 1024.`;
+/**
+ * Error message for internal server error
+ */
+export const ERROR_INTERNAL_SERVER = 'Internal server error';
+/**
+ * Success message for server start
+ */
+export const SUCCESS_SERVER_START = (host: string, port: number): string =>
+  `Backend server listening on http://${host}:${port}`;
+/**
+ * Success message for dashboard start
+ */
+export const SUCCESS_DASHBOARD_START = (host: string, port: number): string =>
+  `Dashboard listening on http://${host}:${port}`;
+/**
+ * Message for graceful shutdown
+ */
+export const MESSAGE_GRACEFUL_SHUTDOWN = 'SIGTERM signal received: closing HTTP server';
+/**
+ * Message for server closed
+ */
+export const MESSAGE_SERVER_CLOSED = 'HTTP server closed';
+/**
+ * Message for dashboard graceful shutdown
+ */
+export const MESSAGE_DASHBOARD_GRACEFUL_SHUTDOWN = 'SIGTERM signal received: closing dashboard server';
+/**
+ * Message for dashboard closed
+ */
+export const MESSAGE_DASHBOARD_CLOSED = 'Dashboard server closed';
+/**
+ * Content-Type header for JavaScript
+ */
+export const CONTENT_TYPE_JAVASCRIPT = 'application/javascript';
+/**
+ * Error serving index.html message
+ */
+export const ERROR_SERVING_INDEX_HTML = 'Error serving index.html:';
+/**
+ * Shutdown instruction message
+ */
+export const MESSAGE_SHUTDOWN_INSTRUCTION = 'Press Ctrl+C to quit.';

package/src/constants/port.ts ADDED Viewed

@@ -0,0 +1,20 @@
+/**
+ * Port Constants
+ * Defines valid port range and port-related configuration
+ */
+/**
+ * Minimum valid port number (above system reserved ports)
+ */
+export const PORT_MIN = 1024;
+/**
+ * Maximum valid port number
+ */
+export const PORT_MAX = 65535;
+/**
+ * Port validation error message
+ */
+export const PORT_VALIDATION_ERROR_MESSAGE = (min: number, max: number): string =>
+  `Port must be between ${min} and ${max}`;