buzzster 1.0.1 → 1.0.2

package/.env.example

@@ -1,7 +1,7 @@
 # Buzzster Client - Configuration
 
 # Central API
-BUZZSTER_API=https://api.buzzster.xyz
+BIOFIREWALL_API=http://localhost:3333
 
 # Client Options
 BLOCK_BROWSERS=true

package/README.md

@@ -13,26 +13,26 @@ Express middleware to protect your routes with agent authentication.
 ## Installation
 
 ```bash
-npm install Buzzster-client
+npm install buzzster-client
 ```
 
 ## Quick Start
 
 ```javascript
 const express = require('express');
-const Buzzster = require('Buzzster-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
 
 // Create middleware
-const Buzzster = new Buzzster({
-    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(Buzzster);
+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 Buzzster = new Buzzster({
+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 Buzzster = require('Buzzster-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
 const publicRoutes = require('./routes/public');
@@ -110,8 +110,8 @@ const agentOnlyRoutes = require('./routes/agent-only');
 app.use('/public', publicRoutes);
 
 // Apply Buzzster middleware
-const Buzzster = new Buzzster('http://localhost:3333');
-app.use('/api', Buzzster, agentOnlyRoutes);
+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 Buzzster = new Buzzster('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 app.use((req, res, next) => {
-    Buzzster(req, res, (err) => {
+    buzzster(req, res, (err) => {
         if (err) {
             // Custom error handling
             console.error('Auth error:', err);
@@ -228,10 +228,10 @@ By default, token verification results are cached for 30 seconds:
 // during request bursts
 
 // Clear all cache
-Buzzster.clearCache();
+buzzster.clearCache();
 
 // Clear specific token
-Buzzster.clearCacheEntry(agentId, token);
+buzzster.clearCacheEntry(agentId, token);
 ```
 
 ## Performance Notes
@@ -283,10 +283,10 @@ describe('Protected endpoint', () => {
 ### "Cannot connect to central API"
 ```javascript
 // Check API URL
-const Buzzster = new Buzzster('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
-- 🛡️ [Buzzster-api](../Buzzster-api) — Central API server
-- 🔗 GitHub: https://github.com/openclaw/Buzzster
+- 🛡️ [buzzster-api](../buzzster-api) — Central API server
+- 🔗 GitHub: https://github.com/openclaw/buzzster

package/SKILL.md

@@ -1,9 +1,9 @@
 ---
-name: Buzzster-client
+name: buzzster-client
 version: 3.0.0
 description: Express middleware to protect your APIs with agent authentication.
-homepage: https://github.com/openclaw/Buzzster
-metadata: {"Buzzster-client":{"emoji":"🔒","category":"security"}}
+homepage: https://github.com/openclaw/buzzster
+metadata: {"buzzster-client":{"emoji":"🔒","category":"security"}}
 ---
 
 # Buzzster Client 🔒 SKILL.md
@@ -12,7 +12,7 @@ metadata: {"Buzzster-client":{"emoji":"🔒","category":"security"}}
 
 ---
 
-## What Is Buzzster-client?
+## What Is buzzster-client?
 
 An Express middleware that:
 1. **Blocks browsers** (User-Agent detection)
@@ -28,7 +28,7 @@ An Express middleware that:
 ## Installation
 
 ```bash
-npm install Buzzster-client
+npm install buzzster-client
 ```
 
 ---
@@ -39,15 +39,15 @@ npm install Buzzster-client
 
 ```javascript
 const express = require('express');
-const Buzzster = require('Buzzster-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
 
 // Create middleware
-const Buzzster = new Buzzster('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Protect all routes
-app.use(Buzzster);
+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 Buzzster = new Buzzster({
+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,7 +93,7 @@ const Buzzster = new Buzzster({
     cacheTTL: 30000                   // Cache time-to-live (milliseconds)
 });
 
-app.use(Buzzster);
+app.use(buzzster);
 ```
 
 ### Configuration Options
@@ -165,10 +165,10 @@ Request 4 (07:00:35) → API call ~20ms (cache expired)
 
 ```javascript
 const express = require('express');
-const Buzzster = require('Buzzster-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
-const Buzzster = new Buzzster('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', Buzzster, (req, res) => {
+app.get('/api/secret', buzzster, (req, res) => {
     res.json({
         message: 'Secret data',
         agent: req.agent
     });
 });
 
-app.post('/api/data', Buzzster, (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 Buzzster = new Buzzster('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(Buzzster);
+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', Buzzster, (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', Buzzster, (req, res) => {
 ### Custom Error Handling
 
 ```javascript
-const Buzzster = new Buzzster('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 app.use((req, res, next) => {
-    Buzzster(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 Buzzster = new Buzzster('http://localhost:3333');
+const buzzster = new Buzzster('https://api.buzzster.xyz');
 
 // Middleware
-const requireAgent = Buzzster;
+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', Buzzster, (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)
-Buzzster.clearCache?.();
+buzzster.clearCache?.();
 
 // Or disable caching
-const Buzzster = new Buzzster({
-    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 Buzzster = new Buzzster('http://localhost:3333');
-   app.use('/api', Buzzster);  // Single instance
+   const buzzster = new Buzzster('https://api.buzzster.xyz');
+   app.use('/api', buzzster);  // Single instance
    ```
 
 2. **Use token caching (default):**
    ```javascript
-   const Buzzster = new Buzzster({
-       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 Buzzster = new Buzzster('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 Buzzster = require('Buzzster-client');
+const Buzzster = require('buzzster-client');
 
 const app = express();
 
 // Setup
-const Buzzster = new Buzzster('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', Buzzster, (req, res) => {
+app.get('/api/secret', buzzster, (req, res) => {
     res.json({
         message: 'Secret data',
         agent: {
@@ -656,7 +656,7 @@ app.get('/api/secret', Buzzster, (req, res) => {
     });
 });
 
-app.post('/api/data', Buzzster, (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 Buzzster_API=http://Buzzster-api:3333
+ENV BIOFIREWALL_API=http://buzzster-api:3333
 ENV PORT=8080
 
 EXPOSE 8080
@@ -708,7 +708,7 @@ CMD ["npm", "start"]
 ### Environment Variables
 
 ```bash
-Buzzster_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 Buzzster-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 `/Buzzster-api/README.md` or `npm install Buzzster-api`.
+A: See `/buzzster-api/README.md` or `npm install buzzster-api`.
 
 **Q: Can I customize error messages?**
-A: Yes, implement custom middleware before Buzzster.
+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,10 +755,10 @@ A: Yes! That's the point. Central API is shared.
 
 ## Support
 
-- 📖 [Buzzster-api/SKILL.md](../Buzzster-api/SKILL.md) — Agent registration guide
-- 💓 [Buzzster-api/HEARTBEAT.md](../Buzzster-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/Buzzster
+- 🔗 GitHub: https://github.com/openclaw/buzzster
 
 ---
 

package/client.js

@@ -20,7 +20,7 @@ class BuzzsterClient {
             timeout: this.timeout,
             headers: {
                 'Content-Type': 'application/json',
-                'User-Agent': 'BuzzsterClient/1.0'
+                'User-Agent': 'BuzzsterClient/3.0'
             }
         });
     }

package/middleware.js

@@ -60,6 +60,7 @@ function createMiddleware(options = {}) {
                                 'X-Bio-Token': 'JWT token signed with your private key'
                             }
                         },
+                        documentation: 'https://github.com/openclaw/buzzster',
                         hint: 'Register your agent first at POST /register'
                     });
                 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buzzster",
-  "version": "1.0.1",
+  "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/setup.sh

@@ -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 Buzzster-client"
+    echo "   npm install buzzster-client"
     exit 0
 fi
 
-# Install Buzzster-client
+# Install buzzster-client
 echo ""
-echo "📦 Installing Buzzster-client..."
-npm install Buzzster-client
+echo "📦 Installing buzzster-client..."
+npm install buzzster-client
 
 # Create .env if doesn't exist
 if [ ! -f .env ]; then
@@ -42,7 +42,7 @@ echo "Next steps:"
 echo "1. Update .env with your configuration"
 echo "2. Add middleware to your Express app:"
 echo ""
-echo "   const Buzzster = require('Buzzster-client');"
+echo "   const Buzzster = require('buzzster-client');"
 echo "   const bio = new Buzzster('http://localhost:3333');"
 echo "   app.use(bio);"
 echo ""