buzzster 1.0.0 → 1.0.2

package/.env.example

@@ -1,4 +1,4 @@
-# BioFirewall Client - Configuration
+# Buzzster Client - Configuration
 
 # Central API
 BIOFIREWALL_API=http://localhost:3333

package/README.md

@@ -1,11 +1,11 @@
-# BioFirewall Client
+# Buzzster Client
 
 Express middleware to protect your routes with agent authentication.
 
 ## What It Does
 
 - **Blocks browsers** (User-Agent detection)
-- **Verifies tokens** with central BioFirewall API
+- **Verifies tokens** with central Buzzster API
 - **Caches verification** locally (30s default) to reduce API calls
 - **Attaches agent info** to req.agent
 - **Returns helpful error messages**
@@ -13,26 +13,26 @@ Express middleware to protect your routes with agent authentication.
 ## Installation
 
 ```bash
-npm install biofirewall-client
+npm install buzzster-client
 ```
 
 ## Quick Start
 
 ```javascript
 const express = require('express');
-const BioFirewall = require('biofirewall-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
 
 // Create middleware
-const bioFirewall = new BioFirewall({
-    apiUrl: 'http://localhost:3333',  // Central API
+const buzzster = new Buzzster({
+    apiUrl: 'https://api.buzzster.xyz',  // Central API
     blockBrowsers: true,
     enforceAuthentication: true
 });
 
 // Apply to all routes
-app.use(bioFirewall);
+app.use(buzzster);
 
 // Now only agents can access
 app.get('/api/secret', (req, res) => {
@@ -48,9 +48,9 @@ app.listen(8080);
 ## Configuration Options
 
 ```javascript
-const bioFirewall = new BioFirewall({
+const buzzster = new Buzzster({
     // Required
-    apiUrl: 'http://localhost:3333',
+    apiUrl: 'https://api.buzzster.xyz',
 
     // Optional
     blockBrowsers: true,              // Block User-Agent that look like browsers
@@ -100,7 +100,7 @@ Reduces API calls during request burst
 
 ```javascript
 const express = require('express');
-const BioFirewall = require('biofirewall-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
 const publicRoutes = require('./routes/public');
@@ -109,9 +109,9 @@ const agentOnlyRoutes = require('./routes/agent-only');
 // Public routes (no auth)
 app.use('/public', publicRoutes);
 
-// Apply BioFirewall middleware
-const bioFirewall = new BioFirewall('http://localhost:3333');
-app.use('/api', bioFirewall, agentOnlyRoutes);
+// Apply Buzzster middleware
+const buzzster = new Buzzster('https://api.buzzster.xyz');
+app.use('/api', buzzster, agentOnlyRoutes);
 
 app.listen(8080);
 ```
@@ -119,10 +119,10 @@ app.listen(8080);
 ### Custom Error Handling
 
 ```javascript
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 app.use((req, res, next) => {
-    bioFirewall(req, res, (err) => {
+    buzzster(req, res, (err) => {
         if (err) {
             // Custom error handling
             console.error('Auth error:', err);
@@ -228,16 +228,16 @@ By default, token verification results are cached for 30 seconds:
 // during request bursts
 
 // Clear all cache
-bioFirewall.clearCache();
+buzzster.clearCache();
 
 // Clear specific token
-bioFirewall.clearCacheEntry(agentId, token);
+buzzster.clearCacheEntry(agentId, token);
 ```
 
 ## Performance Notes
 
 - **Local validation:** User-Agent check (instant, no API call)
-- **First request:** API call to central BioFirewall server (~5-50ms)
+- **First request:** API call to central Buzzster server (~5-50ms)
 - **Cached requests:** Served from local cache (<1ms)
 - **Cache hit rate:** ~95% for typical agents
 
@@ -283,10 +283,10 @@ describe('Protected endpoint', () => {
 ### "Cannot connect to central API"
 ```javascript
 // Check API URL
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Verify API is running
-curl http://localhost:3333/health
+curl https://api.buzzster.xyz/health
 ```
 
 ### "Token always invalid"
@@ -321,5 +321,5 @@ MIT
 
 - 📖 [SKILL.md](../SKILL.md) — Full developer guide
 - 🏗️ [ARCHITECTURE.md](../ARCHITECTURE.md) — System design
-- 🛡️ [biofirewall-api](../biofirewall-api) — Central API server
-- 🔗 GitHub: https://github.com/openclaw/biofirewall
+- 🛡️ [buzzster-api](../buzzster-api) — Central API server
+- 🔗 GitHub: https://github.com/openclaw/buzzster

package/SKILL.md

@@ -1,22 +1,22 @@
 ---
-name: biofirewall-client
+name: buzzster-client
 version: 3.0.0
 description: Express middleware to protect your APIs with agent authentication.
-homepage: https://github.com/openclaw/biofirewall
-metadata: {"biofirewall-client":{"emoji":"🔒","category":"security"}}
+homepage: https://github.com/openclaw/buzzster
+metadata: {"buzzster-client":{"emoji":"🔒","category":"security"}}
 ---
 
-# BioFirewall Client 🔒 SKILL.md
+# Buzzster Client 🔒 SKILL.md
 
 **For Developers:** How to protect your APIs with agent-only authentication.
 
 ---
 
-## What Is biofirewall-client?
+## What Is buzzster-client?
 
 An Express middleware that:
 1. **Blocks browsers** (User-Agent detection)
-2. **Verifies tokens** with central BioFirewall API
+2. **Verifies tokens** with central Buzzster API
 3. **Caches verification** locally (30s, reduces API load)
 4. **Attaches agent info** to `req.agent`
 5. **Returns helpful errors**
@@ -28,7 +28,7 @@ An Express middleware that:
 ## Installation
 
 ```bash
-npm install biofirewall-client
+npm install buzzster-client
 ```
 
 ---
@@ -39,15 +39,15 @@ npm install biofirewall-client
 
 ```javascript
 const express = require('express');
-const BioFirewall = require('biofirewall-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
 
 // Create middleware
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Protect all routes
-app.use(bioFirewall);
+app.use(buzzster);
 
 // Now only agents can access
 app.get('/api/secret', (req, res) => {
@@ -82,9 +82,9 @@ curl http://localhost:8080/api/secret \
 ## Configuration
 
 ```javascript
-const bioFirewall = new BioFirewall({
+const buzzster = new Buzzster({
     // Required
-    apiUrl: 'http://localhost:3333',
+    apiUrl: 'https://api.buzzster.xyz',
 
     // Optional
     blockBrowsers: true,              // Block User-Agents that look like browsers
@@ -93,14 +93,14 @@ const bioFirewall = new BioFirewall({
     cacheTTL: 30000                   // Cache time-to-live (milliseconds)
 });
 
-app.use(bioFirewall);
+app.use(buzzster);
 ```
 
 ### Configuration Options
 
 | Option | Default | Purpose |
 |--------|---------|---------|
-| `apiUrl` | required | Central BioFirewall API URL |
+| `apiUrl` | required | Central Buzzster API URL |
 | `blockBrowsers` | true | Block requests that look like browsers |
 | `enforceAuthentication` | true | Require valid authentication |
 | `cacheTokens` | true | Cache token verification locally |
@@ -165,10 +165,10 @@ Request 4 (07:00:35) → API call ~20ms (cache expired)
 
 ```javascript
 const express = require('express');
-const BioFirewall = require('biofirewall-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Public routes (no auth)
 app.get('/', (req, res) => {
@@ -176,14 +176,14 @@ app.get('/', (req, res) => {
 });
 
 // Protected routes (auth required)
-app.get('/api/secret', bioFirewall, (req, res) => {
+app.get('/api/secret', buzzster, (req, res) => {
     res.json({
         message: 'Secret data',
         agent: req.agent
     });
 });
 
-app.post('/api/data', bioFirewall, (req, res) => {
+app.post('/api/data', buzzster, (req, res) => {
     res.json({
         success: true,
         agent: req.agent.id
@@ -197,7 +197,7 @@ app.listen(8080);
 
 ```javascript
 const app = express();
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Health check (no auth)
 app.get('/health', (req, res) => {
@@ -205,7 +205,7 @@ app.get('/health', (req, res) => {
 });
 
 // Protect everything else
-app.use(bioFirewall);
+app.use(buzzster);
 
 app.get('/api/data', (req, res) => {
     res.json({ agent: req.agent.name });
@@ -215,7 +215,7 @@ app.get('/api/data', (req, res) => {
 ### Access Agent Information
 
 ```javascript
-app.get('/api/profile', bioFirewall, (req, res) => {
+app.get('/api/profile', buzzster, (req, res) => {
     // req.agent is populated by middleware
     res.json({
         you: req.agent.name,
@@ -229,10 +229,10 @@ app.get('/api/profile', bioFirewall, (req, res) => {
 ### Custom Error Handling
 
 ```javascript
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 app.use((req, res, next) => {
-    bioFirewall(req, res, (err) => {
+    buzzster(req, res, (err) => {
         if (err) {
             // Custom error handling
             console.error('Auth error:', err);
@@ -249,10 +249,10 @@ app.use((req, res, next) => {
 ### With Route Guards
 
 ```javascript
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Middleware
-const requireAgent = bioFirewall;
+const requireAgent = buzzster;
 
 const requireAdmin = (req, res, next) => {
     if (req.agent.permissions.includes('admin')) {
@@ -317,7 +317,7 @@ X-Bio-Version: 3.0
 Use these in your code:
 
 ```javascript
-app.get('/api/secret', bioFirewall, (req, res) => {
+app.get('/api/secret', buzzster, (req, res) => {
     const headers = res.getHeaders();
     console.log(headers['x-bio-verified']); // 'true'
     console.log(headers['x-bio-agent-name']); // 'MyAgent'
@@ -431,7 +431,7 @@ const newToken = crypto.createToken(privateKey, agentId, metadata, 3600);
 
 **Fix:** Register agent first:
 ```bash
-curl -X POST http://localhost:3333/register \
+curl -X POST https://api.buzzster.xyz/register \
   -d '{"publicKey": "...", "metadata": {...}}'
 ```
 
@@ -446,11 +446,11 @@ By default, token verification results are cached for 30 seconds locally:
 // Typical cache hit rate: 95%+ for normal usage
 
 // Clear all cache (if needed)
-bioFirewall.clearCache?.();
+buzzster.clearCache?.();
 
 // Or disable caching
-const bioFirewall = new BioFirewall({
-    apiUrl: 'http://localhost:3333',
+const buzzster = new Buzzster({
+    apiUrl: 'https://api.buzzster.xyz',
     cacheTokens: false  // No local caching
 });
 ```
@@ -471,14 +471,14 @@ Agent request (Layer 2 API):   ~20ms (central API call)
 
 1. **Reuse middleware instance:**
    ```javascript
-   const bioFirewall = new BioFirewall('http://localhost:3333');
-   app.use('/api', bioFirewall);  // Single instance
+   const buzzster = new Buzzster('https://api.buzzster.xyz');
+   app.use('/api', buzzster);  // Single instance
    ```
 
 2. **Use token caching (default):**
    ```javascript
-   const bioFirewall = new BioFirewall({
-       apiUrl: 'http://localhost:3333',
+   const buzzster = new Buzzster({
+       apiUrl: 'https://api.buzzster.xyz',
        cacheTokens: true,  // Default: ON
        cacheTTL: 30000     // 30 seconds
    });
@@ -578,10 +578,10 @@ curl -v \
 
 ```javascript
 // Check API URL
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Verify API is running
-curl http://localhost:3333/health
+curl https://api.buzzster.xyz/health
 
 // Check firewall rules
 # Allow traffic on 3333
@@ -594,7 +594,7 @@ curl http://localhost:3333/health
 const token = jwt.sign(payload, privateKey, { algorithm: 'RS256' });
 
 // Verify agent is registered
-curl http://localhost:3333/agents/agent_abc123
+curl https://api.buzzster.xyz/agents/agent_abc123
 
 // Check token not expired (max 1 hour old)
 ```
@@ -622,12 +622,12 @@ curl -v \
 
 ```javascript
 const express = require('express');
-const BioFirewall = require('biofirewall-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
 
 // Setup
-const bioFirewall = new BioFirewall('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Middleware
 app.use(express.json());
@@ -645,7 +645,7 @@ app.get('/', (req, res) => {
 });
 
 // Protected routes
-app.get('/api/secret', bioFirewall, (req, res) => {
+app.get('/api/secret', buzzster, (req, res) => {
     res.json({
         message: 'Secret data',
         agent: {
@@ -656,7 +656,7 @@ app.get('/api/secret', bioFirewall, (req, res) => {
     });
 });
 
-app.post('/api/data', bioFirewall, (req, res) => {
+app.post('/api/data', buzzster, (req, res) => {
     res.json({
         success: true,
         message: 'Data received',
@@ -677,7 +677,7 @@ app.use((err, req, res, next) => {
 const PORT = process.env.PORT || 8080;
 app.listen(PORT, () => {
     console.log(`🔒 Protected API running on port ${PORT}`);
-    console.log(`   Central API: http://localhost:3333`);
+    console.log(`   Central API: https://api.buzzster.xyz`);
 });
 ```
 
@@ -697,7 +697,7 @@ RUN npm install
 
 COPY . .
 
-ENV BIOFIREWALL_API=http://biofirewall-api:3333
+ENV BIOFIREWALL_API=http://buzzster-api:3333
 ENV PORT=8080
 
 EXPOSE 8080
@@ -708,7 +708,7 @@ CMD ["npm", "start"]
 ### Environment Variables
 
 ```bash
-BIOFIREWALL_API=http://localhost:3333
+BIOFIREWALL_API=https://api.buzzster.xyz
 NODE_ENV=production
 PORT=8080
 ```
@@ -736,14 +736,14 @@ PORT=8080
 
 ## FAQ
 
-**Q: Can I use biofirewall-client without central API?**
+**Q: Can I use buzzster-client without central API?**
 A: No. It requires a running central API for token verification.
 
 **Q: How do I set up central API?**
-A: See `/biofirewall-api/README.md` or `npm install biofirewall-api`.
+A: See `/buzzster-api/README.md` or `npm install buzzster-api`.
 
 **Q: Can I customize error messages?**
-A: Yes, implement custom middleware before biofirewall.
+A: Yes, implement custom middleware before buzzster.
 
 **Q: How do I handle 404 from central API?**
 A: Middleware will return 500. Ensure central API is reachable.
@@ -755,11 +755,11 @@ A: Yes! That's the point. Central API is shared.
 
 ## Support
 
-- 📖 [biofirewall-api/SKILL.md](../biofirewall-api/SKILL.md) — Agent registration guide
-- 💓 [biofirewall-api/HEARTBEAT.md](../biofirewall-api/HEARTBEAT.md) — Agent activity routine
+- 📖 [buzzster-api/SKILL.md](../buzzster-api/SKILL.md) — Agent registration guide
+- 💓 [buzzster-api/HEARTBEAT.md](../buzzster-api/HEARTBEAT.md) — Agent activity routine
 - 🏗️ [ARCHITECTURE.md](../ARCHITECTURE.md) — System design
-- 🔗 GitHub: https://github.com/openclaw/biofirewall
+- 🔗 GitHub: https://github.com/openclaw/buzzster
 
 ---
 
-*BioFirewall Client v3.0 | Protect your APIs. Verify silicon.* 🔒
+*Buzzster Client v3.0 | Protect your APIs. Verify silicon.* 🔒

package/client.js

@@ -1,10 +1,10 @@
 /**
- * BioFirewall Client - HTTP client for central API
+ * Buzzster Client - HTTP client for central API
  */
 
 const axios = require('axios');
 
-class BioFirewallClient {
+class BuzzsterClient {
     constructor(apiUrl, options = {}) {
         this.apiUrl = apiUrl.replace(/\/$/, ''); // Remove trailing slash
         this.timeout = options.timeout || 5000;
@@ -20,7 +20,7 @@ class BioFirewallClient {
             timeout: this.timeout,
             headers: {
                 'Content-Type': 'application/json',
-                'User-Agent': 'BioFirewallClient/3.0'
+                'User-Agent': 'BuzzsterClient/3.0'
             }
         });
     }
@@ -135,4 +135,4 @@ class BioFirewallClient {
     }
 }
 
-module.exports = BioFirewallClient;
+module.exports = BuzzsterClient;

package/index.js

@@ -1,15 +1,15 @@
 /**
- * BioFirewall Client Module
+ * Buzzster Client Module
  * Express middleware for agent authentication
  */
 
 const createMiddleware = require('./middleware');
-const BioFirewallClient = require('./client');
+const BuzzsterClient = require('./client');
 
 /**
  * Main export: Express middleware factory
  */
-function BioFirewall(options) {
+function Buzzster(options) {
     // If options is a string, treat it as apiUrl
     if (typeof options === 'string') {
         options = { apiUrl: options };
@@ -19,7 +19,7 @@ function BioFirewall(options) {
 }
 
 // Export components
-BioFirewall.createMiddleware = createMiddleware;
-BioFirewall.Client = BioFirewallClient;
+Buzzster.createMiddleware = createMiddleware;
+Buzzster.Client = BuzzsterClient;
 
-module.exports = BioFirewall;
+module.exports = Buzzster;

package/middleware.js

@@ -1,13 +1,13 @@
 /**
- * BioFirewall Client Middleware
+ * Buzzster Client Middleware
  * Express middleware to protect routes with agent authentication
  */
 
-const BioFirewallClient = require('./client');
+const BuzzsterClient = require('./client');
 const rules = require('./rules');
 
 /**
- * Create BioFirewall middleware
+ * Create Buzzster middleware
  */
 function createMiddleware(options = {}) {
     const {
@@ -23,7 +23,7 @@ function createMiddleware(options = {}) {
     }
 
     // Create client
-    const client = new BioFirewallClient(apiUrl, {
+    const client = new BuzzsterClient(apiUrl, {
         cacheTokens,
         cacheTTL
     });
@@ -60,7 +60,7 @@ function createMiddleware(options = {}) {
                                 'X-Bio-Token': 'JWT token signed with your private key'
                             }
                         },
-                        documentation: 'https://github.com/openclaw/biofirewall',
+                        documentation: 'https://github.com/openclaw/buzzster',
                         hint: 'Register your agent first at POST /register'
                     });
                 }
@@ -97,7 +97,7 @@ function createMiddleware(options = {}) {
             next();
 
         } catch (error) {
-            console.error('BioFirewall middleware error:', error);
+            console.error('Buzzster middleware error:', error);
 
             res.status(500).json({
                 success: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buzzster",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Buzzster Client - Express middleware to protect routes with agent authentication",
   "main": "index.js",
   "scripts": {
@@ -14,7 +14,7 @@
     "authentication",
     "agents"
   ],
-  "author": "Comma",
+  "author": "OpenClaw Community",
   "license": "MIT",
   "dependencies": {
     "axios": "^1.6.0",

package/rules.js

@@ -1,5 +1,5 @@
 /**
- * BioFirewall Client - Security Rules
+ * Buzzster Client - Security Rules
  * User-Agent validation (local, no API calls needed)
  */
 

package/setup.sh

@@ -1,8 +1,8 @@
 #!/bin/bash
 
-# BioFirewall Client Setup Script
+# Buzzster Client Setup Script
 
-echo "🔒 BioFirewall Client - Setup"
+echo "🔒 Buzzster Client - Setup"
 echo "======================================"
 
 # Check Node.js
@@ -16,14 +16,14 @@ echo "✅ Node.js $(node --version)"
 # Check if already in a project with express
 if ! grep -q "\"express\"" package.json 2>/dev/null; then
     echo "⚠️  This is a module. Use in your Express project:"
-    echo "   npm install biofirewall-client"
+    echo "   npm install buzzster-client"
     exit 0
 fi
 
-# Install biofirewall-client
+# Install buzzster-client
 echo ""
-echo "📦 Installing biofirewall-client..."
-npm install biofirewall-client
+echo "📦 Installing buzzster-client..."
+npm install buzzster-client
 
 # Create .env if doesn't exist
 if [ ! -f .env ]; then
@@ -42,8 +42,8 @@ echo "Next steps:"
 echo "1. Update .env with your configuration"
 echo "2. Add middleware to your Express app:"
 echo ""
-echo "   const BioFirewall = require('biofirewall-client');"
-echo "   const bio = new BioFirewall('http://localhost:3333');"
+echo "   const Buzzster = require('buzzster-client');"
+echo "   const bio = new Buzzster('http://localhost:3333');"
 echo "   app.use(bio);"
 echo ""
 echo "3. Start your API and test!"