@tinyclaw/plugin-channel-friends 1.1.0-staging.df9eaf8 → 2.0.0

package/dist/index.js

@@ -42,6 +42,7 @@ const friendsPlugin = {
     description: 'Invite-based web chat for friends — powered by FRIENDS.md',
     type: 'channel',
     version: '0.1.0',
+    channelPrefix: 'friend',
     getPairingTools(_secrets, configManager) {
         // Initialize the store early so pairing tools work before start()
         if (!store) {
@@ -87,6 +88,29 @@ const friendsPlugin = {
         await friendsServer.start();
         logger.info(`Friends chat available at http://${host}:${port}/chat`);
     },
+    async sendToUser(userId, message) {
+        if (!friendsServer) {
+            throw new Error('Friends server is not running');
+        }
+        // Parse username from the prefixed format "friend:<username>"
+        const username = userId.replace(/^friend:/, '');
+        if (!username) {
+            throw new Error(`Invalid Friends userId: ${userId}`);
+        }
+        const delivered = friendsServer.pushToUser(username, {
+            type: 'nudge',
+            content: message.content,
+            source: message.source,
+            priority: message.priority,
+            timestamp: new Date().toISOString(),
+        });
+        if (!delivered) {
+            logger.warn(`Friends: user "${username}" has no active push connections`);
+        }
+        else {
+            logger.info(`Friends: sent outbound message to ${userId}`);
+        }
+    },
     async stop() {
         if (friendsServer) {
             friendsServer.stop();

package/dist/server.d.ts

@@ -24,6 +24,11 @@ interface FriendsServerConfig {
 export declare function createFriendsServer(config: FriendsServerConfig): {
     start(): Promise<void>;
     stop(): void;
+    /**
+     * Push an outbound message to all connected SSE clients for a username.
+     * Returns true if at least one client received the message.
+     */
+    pushToUser(username: string, data: Record<string, unknown>): boolean;
     getPort(): number;
 };
 export {};

package/dist/server.js

@@ -68,6 +68,7 @@ export function createFriendsServer(config) {
     const { port, host, store, chatHtml, onMessage, onMessageStream } = config;
     const secure = config.secure ?? (process.env.NODE_ENV === 'production');
     const textEncoder = new TextEncoder();
+    const pushClients = new Map();
     let server = null;
     return {
         async start() {
@@ -168,6 +169,48 @@ export function createFriendsServer(config) {
                         store.updateNickname(friend.username, newNickname);
                         return jsonResponse({ ok: true, nickname: newNickname });
                     }
+                    // ─── Push SSE stream (outbound notifications) ──────────
+                    if (pathname === '/api/push' && request.method === 'GET') {
+                        const friend = authenticateFriend(request, store);
+                        if (!friend) {
+                            return jsonResponse({ error: 'Unauthorized' }, 401);
+                        }
+                        const username = friend.username;
+                        const stream = new ReadableStream({
+                            start(controller) {
+                                const pushClient = { controller, encoder: textEncoder };
+                                if (!pushClients.has(username)) {
+                                    pushClients.set(username, new Set());
+                                }
+                                pushClients.get(username).add(pushClient);
+                                // Heartbeat to keep connection alive
+                                const heartbeat = setInterval(() => {
+                                    try {
+                                        controller.enqueue(textEncoder.encode(': heartbeat\n\n'));
+                                    }
+                                    catch {
+                                        clearInterval(heartbeat);
+                                        pushClients.get(username)?.delete(pushClient);
+                                    }
+                                }, 15_000);
+                                // Clean up on abort
+                                request.signal.addEventListener('abort', () => {
+                                    clearInterval(heartbeat);
+                                    pushClients.get(username)?.delete(pushClient);
+                                    if (pushClients.get(username)?.size === 0) {
+                                        pushClients.delete(username);
+                                    }
+                                });
+                            },
+                        });
+                        return new Response(stream, {
+                            headers: {
+                                'Content-Type': 'text/event-stream',
+                                'Cache-Control': 'no-cache',
+                                Connection: 'keep-alive',
+                            },
+                        });
+                    }
                     // ─── Chat API (message) ─────────────────────────────────
                     if (pathname === '/api/chat' && request.method === 'POST') {
                         const friend = authenticateFriend(request, store);
@@ -283,9 +326,34 @@ export function createFriendsServer(config) {
             if (server) {
                 server.stop();
                 server = null;
+                // Clean up all push clients
+                pushClients.clear();
                 logger.info('Friends chat server stopped');
             }
         },
+        /**
+         * Push an outbound message to all connected SSE clients for a username.
+         * Returns true if at least one client received the message.
+         */
+        pushToUser(username, data) {
+            const clients = pushClients.get(username);
+            if (!clients || clients.size === 0)
+                return false;
+            const payload = `data: ${JSON.stringify(data)}\n\n`;
+            const dead = [];
+            for (const pc of clients) {
+                try {
+                    pc.controller.enqueue(pc.encoder.encode(payload));
+                }
+                catch {
+                    dead.push(pc);
+                }
+            }
+            for (const dc of dead) {
+                clients.delete(dc);
+            }
+            return clients.size > 0 || dead.length < (clients.size + dead.length);
+        },
         getPort() {
             return server?.port || port;
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinyclaw/plugin-channel-friends",
-  "version": "1.1.0-staging.df9eaf8",
+  "version": "2.0.0",
   "description": "Friends web chat channel plugin for Tiny Claw",
   "license": "GPL-3.0",
   "author": "Waren Gonzaga",