openkbs-pulse 1.0.5 → 1.0.7

package/README.md

@@ -177,6 +177,31 @@ pulse.connect();
 </html>
 ```
 
+## Server SDK
+
+For server-side usage (Elastic Functions, Node.js):
+
+```javascript
+import pulse from 'openkbs-pulse/server';
+
+// Get a token for client WebSocket auth
+const { token, endpoint, region } = await pulse.getToken(kbId, apiKey, userId);
+
+// Publish to channel
+await pulse.publish('channel', 'event', { data });
+
+// Get presence info
+const { count, members } = await pulse.presence('channel');
+```
+
+### Server SDK Functions
+
+| Function | Parameters | Description |
+|----------|------------|-------------|
+| `getToken(kbId, apiKey, userId)` | kbId, apiKey (required), userId (default: 'anonymous') | Get WebSocket auth token |
+| `publish(channel, event, data)` | All required | Publish message to channel |
+| `presence(channel)` | channel name | Get online count and members |
+
 ## License
 
 MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openkbs-pulse",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Real-time WebSocket SDK for OpenKBS",
   "main": "pulse.js",
   "types": "pulse.d.ts",

package/server.js

@@ -11,6 +11,34 @@
 const PULSE_API = process.env.PULSE_API_URL || 'https://kb.openkbs.com';
 
 const pulse = {
+    /**
+     * Get a Pulse token for WebSocket authentication
+     * @param {string} kbId - KB ID (optional, uses env var)
+     * @param {string} apiKey - API Key (optional, uses env var)
+     * @param {string} userId - User identifier (default: 'anonymous')
+     * @returns {Promise<{token, endpoint, region, expiresIn}>}
+     */
+    async getToken(kbId, apiKey, userId = 'anonymous') {
+        const kb = kbId || process.env.OPENKBS_KB_ID;
+        const key = apiKey || process.env.OPENKBS_API_KEY;
+
+        if (!kb || !key) {
+            throw new Error('[Pulse] kbId and apiKey required');
+        }
+
+        const res = await fetch(PULSE_API, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                action: 'createPulseToken',
+                kbId: kb,
+                apiKey: key,
+                userId
+            })
+        });
+        return res.json();
+    },
+
     /**
      * Publish a message to a channel
      * @param {string} channel - Channel name