invariant-guard 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Invariant Guard
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# Invariant Guard 🛡️
+
+A lightweight, zero-dependency runtime logic integrity engine for JavaScript. It ensures your business logic invariants are never broken silently.
+
+## ✨ Features
+
+- **Runtime Integrity:** Prevents logic violations instantly.
+- **Smart Rollback:** Automatically reverts data if a rule is broken.
+- **Zero Overhead:** Disables completely in production mode.
+- **Deep Watching:** Monitors nested objects and arrays correctly.
+
+## 📦 Installation
+
+```bash
+npm install invariant-guard

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "invariant-guard",
+  "version": "1.0.0",
+  "description": "A runtime logic integrity engine for JavaScript with zero production overhead.",
+  "main": "src/index.js",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "scripts": {
+    "test": "node test.js",
+    "test:prod": "node test-prod.js"
+  },
+  "keywords": [
+    "invariant",
+    "validation",
+    "logic",
+    "integrity",
+    "proxy"
+  ],
+  "author": "",
+  "license": "MIT",
+  "files": [
+    "src"
+  ]
+}

package/src/index.js

@@ -0,0 +1,41 @@
+import { registry } from './registry.js';
+import { createInvariant } from './observer.js';
+
+// Default configuration
+const config = {
+  isProduction: false, // By default, we are in DEV mode (Protections ON)
+  onError: null // Optional custom error handler
+};
+
+const Invariant = {
+  // Setup global configuration
+  configure: (options) => {
+    if (typeof options.isProduction === 'boolean') {
+      config.isProduction = options.isProduction;
+    }
+    if (typeof options.onError === 'function') {
+      config.onError = options.onError;
+    }
+  },
+
+  // Define a rule
+  rule: (contextName, ruleName, validatorFn) => {
+    // In production, we might skip registering rules to save memory, 
+    // but keeping them is fine as long as we don't RUN them.
+    registry.register(contextName, ruleName, validatorFn);
+  },
+
+  // Watch an object
+  watch: (target, contextName) => {
+    // CRITICAL PERFORMANCE CHECK
+    // If we are in Production, return the raw object immediately.
+    // No Proxy, No Overhead.
+    if (config.isProduction) {
+      return target;
+    }
+
+    return createInvariant(target, contextName);
+  }
+};
+
+export default Invariant;

package/src/observer.js

@@ -0,0 +1,43 @@
+import { registry } from './registry.js';
+
+export function createInvariant(target, contextName, root = null) {
+  const actualRoot = root || target;
+
+  return new Proxy(target, {
+    get(obj, prop) {
+      const value = obj[prop];
+      if (typeof value === 'object' && value !== null) {
+        return createInvariant(value, contextName, actualRoot);
+      }
+      return value;
+    },
+
+    set(obj, prop, value) {
+      const isArray = Array.isArray(obj);
+      const oldLength = isArray ? obj.length : 0;
+      const oldValue = obj[prop];
+
+      obj[prop] = value;
+
+      const rules = registry.getRules(contextName);
+      for (const rule of rules) {
+        try {
+          if (!rule.check(actualRoot)) {
+            throw new Error(`Rule "${rule.id}" failed.`);
+          }
+        } catch (err) {
+          
+          obj[prop] = oldValue;
+
+          if (isArray && obj.length !== oldLength) {
+             obj.length = oldLength; 
+          }
+
+          throw new Error(`[Invariant.js] Violation in "${contextName}": ${err.message}`);
+        }
+      }
+
+      return true;
+    }
+  });
+}

package/src/registry.js

@@ -0,0 +1,22 @@
+class InvariantRegistry {
+  constructor() {
+    this.store = new Map();
+  }
+
+  register(contextName, ruleName, validatorFn) {
+    if (!this.store.has(contextName)) {
+      this.store.set(contextName, []);
+    }
+    
+    this.store.get(contextName).push({
+      id: ruleName,
+      check: validatorFn 
+    });
+  }
+
+  getRules(contextName) {
+    return this.store.get(contextName) || [];
+  }
+}
+
+export const registry = new InvariantRegistry();