stratifyjs 1.0.0

package/lib/core/validation.js

@@ -0,0 +1,51 @@
+import { hasRequiredLayer, isKnownLayer, isDependencyAllowed } from './rules.js';
+/**
+ * Validate all packages against layer configuration.
+ */
+export function validatePackages(packages, config) {
+    const violations = [];
+    const packageMap = new Map(packages.map(pkg => [pkg.name, pkg]));
+    for (const pkg of packages) {
+        // Rule 1: Check if package has a layer field
+        if (!hasRequiredLayer(pkg)) {
+            violations.push({
+                type: 'missing-layer',
+                package: pkg.name,
+                message: `Package "${pkg.name}" is missing the required "layer" field in package.json`,
+            });
+            continue; // Cannot validate further without layer
+        }
+        const layer = pkg.layer;
+        // Rule 2: Layer must be defined in config
+        if (!isKnownLayer(layer, config.layers)) {
+            violations.push({
+                type: 'unknown-layer',
+                package: pkg.name,
+                message: `Package "${pkg.name}" has unknown layer "${layer}". Valid layers: ${Object.keys(config.layers).join(', ')}`,
+            });
+            continue;
+        }
+        // Rule 3: Each dependency must target an allowed layer
+        const layerDef = config.layers[layer];
+        for (const depName of pkg.dependencies) {
+            const depPkg = packageMap.get(depName);
+            if (!depPkg || !depPkg.layer) {
+                continue; // Skip dependencies that are not discovered or have no layer
+            }
+            if (!isDependencyAllowed(layer, depPkg.layer, layerDef.allowedDependencies)) {
+                violations.push({
+                    type: 'invalid-dependency',
+                    package: pkg.name,
+                    message: `Layer violation: "${pkg.name}" (${layer}) cannot depend on "${depPkg.name}" (${depPkg.layer})`,
+                    details: {
+                        fromLayer: layer,
+                        toPackage: depPkg.name,
+                        toLayer: depPkg.layer,
+                        allowedLayers: layerDef.allowedDependencies,
+                    },
+                });
+            }
+        }
+    }
+    return violations;
+}

package/lib/types/types.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Represents a discovered package in the monorepo
+ */
+export interface Package {
+    name: string;
+    layer?: string;
+    dependencies: string[];
+    path: string;
+}
+/**
+ * Layer definition in the configuration
+ */
+export interface LayerDefinition {
+    description?: string;
+    allowedDependencies: string[];
+}
+/**
+ * Map of layer names to their definitions
+ */
+export type LayerMap = Record<string, LayerDefinition>;
+/**
+ * Enforcement configuration
+ */
+export interface EnforcementConfig {
+    mode: 'error' | 'warn' | 'off';
+}
+/**
+ * Workspace discovery configuration
+ */
+export interface WorkspaceConfig {
+    patterns: string[];
+}
+/**
+ * Layer configuration file (as written by user)
+ */
+export interface LayerConfig {
+    layers: LayerMap;
+    workspaces?: Partial<WorkspaceConfig>;
+    enforcement?: Partial<EnforcementConfig>;
+}
+/**
+ * Resolved config with all defaults applied
+ */
+export interface ResolvedConfig {
+    layers: LayerMap;
+    workspaces: WorkspaceConfig;
+    enforcement: EnforcementConfig;
+}
+/**
+ * Violation types
+ */
+export type ViolationType = 'missing-layer' | 'unknown-layer' | 'invalid-dependency';
+/**
+ * A single validation violation
+ */
+export interface Violation {
+    type: ViolationType;
+    package: string;
+    message: string;
+    details?: {
+        fromLayer?: string;
+        toPackage?: string;
+        toLayer?: string;
+        allowedLayers?: string[];
+    };
+}

package/lib/types/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "stratifyjs",
+  "version": "1.0.0",
+  "description": "Enforce architectural layer boundaries in monorepos",
+  "type": "module",
+  "bin": {
+    "stratify": "./lib/cli/index.js"
+  },
+  "main": "./lib/api/index.js",
+  "types": "./lib/api/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/api/index.ts",
+      "types": "./lib/api/index.d.ts",
+      "default": "./lib/api/index.js"
+    },
+    "./cli": {
+      "source": "./src/cli/index.ts",
+      "types": "./lib/cli/index.d.ts",
+      "default": "./lib/cli/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "start": "node lib/cli/index.js",
+    "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js",
+    "test:watch": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "yarn build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/smikula/stratifyjs.git"
+  },
+  "bugs": {
+    "url": "https://github.com/smikula/stratifyjs/issues"
+  },
+  "homepage": "https://github.com/smikula/stratifyjs#readme",
+  "keywords": [
+    "monorepo",
+    "architecture",
+    "layers",
+    "dependency",
+    "enforcement"
+  ],
+  "files": [
+    "lib/",
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "commander": "^14.0.3",
+    "glob": "^10.0.0",
+    "picocolors": "^1.1.0"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.2.3",
+    "jest": "^29.5.0",
+    "prettier": "^3.8.1",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.3.2"
+  },
+  "license": "MIT"
+}