heicat 0.1.2

package/examples/express-app/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "heicat-example",
+  "version": "1.0.0",
+  "description": "Example Express app with Contract Studio",
+  "main": "server.js",
+  "scripts": {
+    "start": "node server.js",
+    "dev": "node --watch server.js",
+    "init-contracts": "node ../../packages/cli/dist/cli.js init",
+    "validate-contracts": "node ../../packages/cli/dist/cli.js validate",
+    "status": "node ../../packages/cli/dist/cli.js status"
+  },
+  "dependencies": {
+    "@heicat/core": "file:../../packages/core",
+    "cors": "^2.8.5",
+    "express": "^4.18.0"
+  },
+  "devDependencies": {
+    "@heicat/cli": "file:../../packages/cli"
+  }
+}

package/examples/express-app/server.js

@@ -0,0 +1,116 @@
+const express = require('express');
+const cors = require('cors');
+const { contractMiddleware } = require('@contract-studio/core');
+
+const app = express();
+
+// Enable CORS for GUI requests
+app.use(cors({
+  origin: ['http://localhost:3333', 'http://127.0.0.1:3333'],
+  credentials: true
+}));
+
+app.use(express.json());
+
+// Add Contract Studio middleware
+app.use(
+  contractMiddleware({
+    contractsPath: './contracts',
+    mode: 'dev'  // Use 'dev' for development, 'strict' for production
+  })
+);
+
+// In-memory user store (for demo purposes)
+let users = [];
+let nextId = 1;
+
+// Contract Studio API endpoints
+app.get('/api/violations', (req, res) => {
+  const engine = req._contractEngine;
+  if (engine) {
+    res.json({
+      violations: engine.getViolations() || [],
+      stats: engine.getStats() || { total: 0, errors: 0, warnings: 0 }
+    });
+  } else {
+    res.json({
+      violations: [],
+      stats: { total: 0, errors: 0, warnings: 0 }
+    });
+  }
+});
+
+// Routes
+app.post('/users', (req, res) => {
+  const { email, password, name } = req.body;
+
+  // Check if user already exists
+  const existingUser = users.find(u => u.email === email);
+  if (existingUser) {
+    return res.status(409).json({
+      message: 'User with this email already exists'
+    });
+  }
+
+  // Validate password length (this should be caught by contract validation)
+  if (!password || password.length < 8) {
+    return res.status(400).json({
+      message: 'Password must be at least 8 characters long'
+    });
+  }
+
+  const user = {
+    id: nextId++,
+    email,
+    name: name || '',
+    createdAt: new Date().toISOString()
+  };
+
+  users.push(user);
+
+  res.status(201).json(user);
+});
+
+app.get('/users', (req, res) => {
+  res.json(users);
+});
+
+app.post('/auth/login', (req, res) => {
+  const { email, password } = req.body;
+
+  const user = users.find(u => u.email === email);
+  if (!user) {
+    return res.status(401).json({
+      message: 'Invalid credentials'
+    });
+  }
+
+  // In a real app, you'd verify the password hash
+  // For demo, just check if password exists
+  if (!password) {
+    return res.status(401).json({
+      message: 'Invalid credentials'
+    });
+  }
+
+  // Return token and user info
+  res.json({
+    token: `jwt-token-for-${user.id}`,
+    user: {
+      id: user.id,
+      email: user.email
+    }
+  });
+});
+
+// Error handling middleware
+app.use((err, req, res, next) => {
+  console.error(err);
+  res.status(500).json({ message: 'Internal server error' });
+});
+
+const PORT = process.env.PORT || 3000;
+app.listen(PORT, () => {
+  console.log(`🚀 Server running on http://localhost:${PORT}`);
+  console.log(`📋 Heicat monitoring enabled`);
+});

package/jest.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  projects: [
+    '<rootDir>/packages/*/jest.config.js'
+  ]
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "heicat",
+  "version": "0.1.2",
+  "description": "Runtime-enforced API contract system for Node.js",
+  "main": "index.js",
+  "scripts": {
+    "build": "npm run build --workspaces",
+    "build:core": "npm run build --workspace=@heicat/core",
+    "build:cli": "npm run build --workspace=@heicat/cli",
+    "clean": "npm run clean --workspaces",
+    "test": "npm run test --workspaces",
+    "lint": "npm run lint --workspaces",
+    "dev": "npm run dev --workspaces",
+    "prepare": "npm run build",
+    "release": "npm version patch && npm publish --workspaces"
+  },
+  "workspaces": [
+    "packages/*"
+  ],
+  "keywords": [
+    "api",
+    "contract",
+    "validation",
+    "runtime",
+    "express",
+    "nodejs",
+    "middleware"
+  ],
+  "author": "Backend Contract Studio",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/heicat.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-org/heicat/issues"
+  },
+  "homepage": "https://github.com/your-org/heicat#readme",
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/packages/cli/jest.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  testMatch: ['**/__tests__/**/*.test.ts', '**/*.test.ts'],
+  collectCoverageFrom: ['src/**/*.ts', '!src/**/*.d.ts'],
+  setupFilesAfterEnv: []
+};