build-firewall-plugin

Build-time Rspack plugin for enforcing architectural dependency rules between project layers.

The plugin analyzes the actual module graph, not raw import statements, and reports violations only for real, used dependencies.

📦 Installation

npm install build-firewall-plugin --save-dev

yarn add build-firewall-plugin -D

🛠️ Config Example

// rspack.config.ts
import { BuildFirewallPlugin } from "build-firewall-plugin";

module.exports = {
  // ...your config,

  plugins: [
    new BuildFirewallPlugin({
        path: 'my-project-rules.json',
    }),
  ],
};

📋 Rules file example

// my-project-rules.json

{
  "layers": ["services", "models", "widgets"],
  "rules": {
    "services": {
      "allow": ["models"],
      "deny": ["widgets"]
    }
  }
}

💾 Output Example

[Build Firewall Plugin] Starting... 
[Build Firewall Plugin] Your build-firewall-plugin.rules.json file is valid! 

[Build Firewall Plugin] Module /src/services/api.ts imports forbidden module /src/widgets/main.ts

License

MIT license