keyline-cli 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# KeyLine
+
+> **Secure Terminal Communication Protocol**
+
+KeyLine is a persistent, encrypted chat protocol for the terminal. No browsers. No trackers. Just raw, distributed messaging for the modern node.
+
+![Banner](https://github.com/user-attachments/assets/placeholder)
+
+## Features
+
+- 🔒 **Secure**: End-to-end encrypted messaging (via Supabase RLS).
+- 🆔 **Identity**: Unique alphanumeric IDs (e.g., `ABC1234`).
+- ⚡ **Real-time**: Instant message delivery using Supabase Realtime.
+- 🎨 **Hacker UX**: Premium retro-terminal interface.
+
+## Installation
+
+You can run KeyLine directly using `npx` or install it globally.
+
+### Option 1: Quick Run (Recommended)
+
+```bash
+npx keyline
+```
+
+### Option 2: Global Install
+
+```bash
+npm install -g keyline
+keyline
+```
+
+## Configuration (Optional)
+
+By default, KeyLine connects to the official secure public network. No configuration is required.
+
+**Advanced: Self-Hosting**
+If you want to host your own backend:
+1.  Create a `.env` file in the directory where you run the tool.
+2.  Add your Supabase credentials:
+
+```env
+SUPABASE_URL=your_supabase_project_url
+SUPABASE_ANON_KEY=your_supabase_anon_key
+```
+
+> If you are the host, ensure your Supabase instance has the correct schema applied (see `update_schema.sql`).
+
+## Commands
+
+- `/help` - Show protocol list
+- `/clear` - Flush display buffer
+- `/info` - Peer identity status
+- `/shrug` - ¯\\_(ツ)_/¯
+- `/flip` - (╯°□°）╯︵ ┻━┻
+- `/nuke` - Emergency disconnect
+
+## License
+
+ISC

package/keyline.js

@@ -0,0 +1,577 @@
+#!/usr/bin/env node
+const { createClient } = require('@supabase/supabase-js');
+const inquirer = require('inquirer');
+const chalk = require('chalk');
+const figlet = require('figlet');
+const ora = require('ora');
+const { customAlphabet } = require('nanoid');
+require('dotenv').config();
+
+// Default Configuration (KeyLine Public Network)
+const DEFAULT_CONFIG = {
+    SUPABASE_URL: 'https://xpzaefdnzddsibxqgwnx.supabase.co',
+    SUPABASE_ANON_KEY: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InhwemFlZmRuemRkc2lieHFnd254Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjY5MDk3MDksImV4cCI6MjA4MjQ4NTcwOX0.tyjkDMoC34msnoBOky7JUVuuhEw4m7cLsl86JUTSPQY'
+};
+
+const SUPABASE_URL = process.env.SUPABASE_URL || DEFAULT_CONFIG.SUPABASE_URL;
+const SUPABASE_ANON_KEY = process.env.SUPABASE_ANON_KEY || DEFAULT_CONFIG.SUPABASE_ANON_KEY;
+
+const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);
+const nanoid = customAlphabet('ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789', 7);
+
+const hackerTheme = {
+    primary: chalk.greenBright,
+    secondary: chalk.green,
+    error: chalk.redBright,
+    info: chalk.cyan,
+    system: chalk.white.dim,
+    warning: chalk.yellowBright,
+    accent: chalk.magentaBright,
+    bg: chalk.bgBlack
+};
+
+const SLEEP = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+
+async function typewriter(text, color = hackerTheme.primary, speed = 10) {
+    for (const char of text) {
+        process.stdout.write(color(char));
+        await SLEEP(speed);
+    }
+    process.stdout.write('\n');
+}
+
+function clearConsole() {
+    process.stdout.write('\x1Bc');
+}
+
+function renderBox(content, title = 'SYSTEM') {
+    const lines = content.split('\n');
+    const width = Math.max(...lines.map(l => l.length), title.length) + 4;
+    const border = '═'.repeat(width);
+    
+    console.log(hackerTheme.secondary(`╔═ ${title} ${'═'.repeat(width - title.length - 3)}╗`));
+    lines.forEach(line => {
+        console.log(hackerTheme.secondary('║ ') + hackerTheme.primary(line.padEnd(width - 2)) + hackerTheme.secondary('║'));
+    });
+    console.log(hackerTheme.secondary(`╚${border}╝`));
+}
+
+function showBanner() {
+    console.log(hackerTheme.primary(figlet.textSync('KeyLine', { horizontalLayout: 'full' })));
+    console.log(hackerTheme.system('--- SECURE TERMINAL CONNECTION ESTABLISHED ---\n'));
+}
+
+async function generateUniqueID() {
+    // ID format: 3 letters + 4 numbers (e.g., ABC1234)
+    const letters = customAlphabet('ABCDEFGHIJKLMNOPQRSTUVWXYZ', 3)();
+    const numbers = customAlphabet('0123456789', 4)();
+    return `${letters}${numbers}`;
+}
+
+async function main() {
+    clearConsole();
+    showBanner();
+
+    // Credentials now guaranteed by defaults
+
+    const { action } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'action',
+            message: hackerTheme.primary('Select initial protocol:'),
+            choices: [
+                { name: hackerTheme.secondary('[LOGIN] Access existing terminal'), value: 'login' },
+                { name: hackerTheme.secondary('[SIGNUP] Register new node'), value: 'signup' },
+                { name: hackerTheme.error('[EXIT] Terminate session'), value: 'exit' }
+            ]
+        }
+    ]);
+
+    if (action === 'exit') process.exit(0);
+    
+    if (action === 'signup') {
+        await handleSignup();
+    } else {
+        await handleLogin();
+    }
+}
+
+async function handleSignup() {
+    const { displayName } = await inquirer.prompt([
+        { type: 'input', name: 'displayName', message: hackerTheme.primary('Enter Display Name (or type "back"):') }
+    ]);
+
+    if (displayName.toLowerCase() === 'back') return main();
+
+    const { email, password, chatPassword } = await inquirer.prompt([
+        { type: 'input', name: 'email', message: hackerTheme.primary('Enter Email (for identity):') },
+        { type: 'password', name: 'password', message: hackerTheme.primary('Enter Secure Account Password:') },
+        { type: 'password', name: 'chatPassword', message: hackerTheme.warning('Set Chat Access Password (others need this to add you):') }
+    ]);
+
+    const spinner = ora(hackerTheme.info('Encrypting identity and generating ID...')).start();
+
+    try {
+        const { data: authData, error: authError } = await supabase.auth.signUp({
+            email,
+            password
+        });
+
+        if (authError) throw authError;
+
+        if (authData.session) {
+            const uniqueID = await generateUniqueID();
+            
+            const { error: profileError } = await supabase
+                .from('profiles')
+                .insert([
+                    { id: authData.user.id, display_name: displayName, unique_id: uniqueID, chat_password: chatPassword }
+                ]);
+
+            if (profileError) throw profileError;
+
+            spinner.succeed(hackerTheme.primary(`Identity registered! Your Unique ID is: ${chalk.white.bold(uniqueID)}`));
+            await showMainMenu(authData.user);
+        } else {
+            spinner.succeed(hackerTheme.primary('Identity registered!'));
+            console.log(hackerTheme.warning('\n[SYSTEM] ATTENTION: Verification required.'));
+            console.log(hackerTheme.info('Please check your mailbox and verify your email ID.'));
+            console.log(hackerTheme.info('Return to this terminal and [LOGIN] after verification.\n'));
+            
+            await inquirer.prompt([{ type: 'input', name: 'continue', message: hackerTheme.system('Press Enter to return to main menu...') }]);
+            await main();
+        }
+    } catch (err) {
+        spinner.fail(hackerTheme.error(`Registration failed: ${err.message}`));
+        await inquirer.prompt([{ type: 'input', name: 'continue', message: hackerTheme.system('Press Enter to retry...') }]);
+        await main();
+    }
+}
+
+async function handleLogin() {
+    const { email } = await inquirer.prompt([
+        { type: 'input', name: 'email', message: hackerTheme.primary('Enter Email (or type "back"):') }
+    ]);
+
+    if (email.toLowerCase() === 'back') return main();
+
+    const { password } = await inquirer.prompt([
+        { type: 'password', name: 'password', message: hackerTheme.primary('Enter Password:') }
+    ]);
+
+    const spinner = ora(hackerTheme.info('Authenticating credentials...')).start();
+
+    try {
+        const { data, error } = await supabase.auth.signInWithPassword({
+            email,
+            password
+        });
+
+        if (error) throw error;
+
+        spinner.succeed(hackerTheme.primary('Access granted. Welcome back.'));
+        await showMainMenu(data.user);
+    } catch (err) {
+        spinner.fail(hackerTheme.error(`Authentication failed: ${err.message}`));
+        await inquirer.prompt([{ type: 'input', name: 'continue', message: hackerTheme.system('Press Enter to retry...') }]);
+        await main();
+    }
+}
+
+async function handleMissingProfile(user) {
+    const { displayName, chatPassword } = await inquirer.prompt([
+        { type: 'input', name: 'displayName', message: hackerTheme.primary('Complete your profile. Enter Display Name:') },
+        { type: 'password', name: 'chatPassword', message: hackerTheme.warning('Set Chat Access Password (others need this to add you):') }
+    ]);
+
+    const spinner = ora(hackerTheme.info('Completing registration...')).start();
+    const uniqueID = await generateUniqueID();
+
+    try {
+        const { error: profileError } = await supabase
+            .from('profiles')
+            .insert([
+                { id: user.id, display_name: displayName, unique_id: uniqueID, chat_password: chatPassword }
+            ]);
+
+        if (profileError) throw profileError;
+
+        spinner.succeed(hackerTheme.primary(`Profile created! Your ID is: ${chalk.white.bold(uniqueID)}`));
+        await showMainMenu(user);
+    } catch (err) {
+        spinner.fail(hackerTheme.error(`Failed to create profile: ${err.message}`));
+        await inquirer.prompt([{ type: 'input', name: 'continue', message: hackerTheme.system('Press Enter to retry...') }]);
+        await main();
+    }
+}
+
+async function showMainMenu(user) {
+    const { error: profileError, data: profile } = await supabase
+        .from('profiles')
+        .select('*')
+        .eq('id', user.id)
+        .single();
+
+    if (profileError) {
+        if (profileError.code === 'PGRST116') {
+            console.log(hackerTheme.warning('\n[SYSTEM] Warning: Profile not found for this account.'));
+            return handleMissingProfile(user);
+        }
+        console.log(hackerTheme.error(`[ERROR] Profile retrieval failed: ${profileError.message}`));
+        await inquirer.prompt([{ type: 'input', name: 'continue', message: hackerTheme.system('Press Enter to return to main menu...') }]);
+        return main();
+    }
+
+    clearConsole();
+    showBanner();
+    console.log(hackerTheme.info(`User: ${profile.display_name} | ID: ${profile.unique_id}\n`));
+
+    const { action } = await inquirer.prompt([
+        {
+            type: 'list',
+            name: 'action',
+            message: hackerTheme.primary('COMMAND MENU:'),
+            choices: [
+                { name: hackerTheme.secondary('[SEARCH] Find user by ID'), value: 'search' },
+                { name: hackerTheme.secondary('[REQUESTS] View chat requests'), value: 'requests' },
+                { name: hackerTheme.secondary('[CHATS] My active conversations'), value: 'chats' },
+                { name: hackerTheme.error('[LOGOUT] Disconnect'), value: 'logout' }
+            ]
+        }
+    ]);
+
+    switch (action) {
+        case 'search':
+            await handleSearch(profile);
+            break;
+        case 'requests':
+            await handleRequests(profile);
+            break;
+        case 'chats':
+            await handleChats(profile);
+            break;
+        case 'logout':
+            await supabase.auth.signOut();
+            await main();
+            break;
+    }
+}
+
+async function handleSearch(profile) {
+    const { targetID } = await inquirer.prompt([
+        { type: 'input', name: 'targetID', message: hackerTheme.primary('Enter Unique ID to search (or type "back"):') }
+    ]);
+
+    if (targetID.toLowerCase() === 'back') return showMainMenu({ id: profile.id });
+
+    if (targetID === profile.unique_id) {
+        console.log(hackerTheme.error('[ERROR] Cannot search for yourself.'));
+        return showMainMenu({ id: profile.id });
+    }
+
+    const spinner = ora(hackerTheme.info('Pinging target ID...')).start();
+
+    try {
+        const { data: targetProfile, error } = await supabase
+            .from('profiles')
+            .select('*')
+            .eq('unique_id', targetID)
+            .single();
+
+        if (error || !targetProfile) {
+            spinner.fail(hackerTheme.error('ID not found in network.'));
+        } else {
+            spinner.stop();
+            // Check if relationship already exists
+            const { data: existing, error: checkError } = await supabase
+                .from('chat_requests')
+                .select('*')
+                .or(`and(sender_id.eq.${profile.id},receiver_id.eq.${targetProfile.id}),and(sender_id.eq.${targetProfile.id},receiver_id.eq.${profile.id})`)
+                .single();
+
+            if (existing) {
+                if (existing.status === 'accepted') {
+                    console.log(hackerTheme.info(`[SYSTEM] Connection with ${targetProfile.display_name} already exists.`));
+                } else if (existing.sender_id === profile.id) {
+                    console.log(hackerTheme.info(`[SYSTEM] Signal already transmitted. Waiting for ${targetProfile.display_name} to accept.`));
+                } else {
+                    console.log(hackerTheme.warning(`[SYSTEM] ${targetProfile.display_name} has already sent you a request! Check your [REQUESTS].`));
+                }
+            } else {
+                console.log(hackerTheme.primary(`Target found: ${targetProfile.display_name}`));
+                
+                // Chat Password Verification
+                if (targetProfile.chat_password) {
+                     const { inputPassword } = await inquirer.prompt([
+                        { type: 'password', name: 'inputPassword', message: hackerTheme.warning(`Enter Chat Access Password for ${targetProfile.unique_id}:`) }
+                    ]);
+                    
+                    if (inputPassword !== targetProfile.chat_password) {
+                        console.log(hackerTheme.error('[ACCESS DENIED] Incorrect Chat Password.'));
+                        return showMainMenu({ id: profile.id });
+                    }
+                    console.log(hackerTheme.secondary('[ACCESS GRANTED] Credentials verified.'));
+                }
+
+                const { confirm } = await inquirer.prompt([
+                    {
+                        type: 'confirm',
+                        name: 'confirm',
+                        message: hackerTheme.primary(`Send chat request to ${targetProfile.display_name}?`),
+                        default: true
+                    }
+                ]);
+
+                if (confirm) {
+                    const { error: reqError } = await supabase
+                        .from('chat_requests')
+                        .insert([
+                            { sender_id: profile.id, receiver_id: targetProfile.id, status: 'pending' }
+                        ]);
+
+                    if (reqError) throw reqError;
+                    console.log(hackerTheme.primary('Request transmitted successfully.'));
+                }
+            }
+        }
+    } catch (err) {
+        spinner.fail(hackerTheme.error(`Operation failed: ${err.message}`));
+    }
+    
+    await showMainMenu({ id: profile.id });
+}
+
+async function handleRequests(profile) {
+    const spinner = ora(hackerTheme.info('Fetching pending requests...')).start();
+
+    try {
+        const { data: requests, error } = await supabase
+            .from('chat_requests')
+            .select(`
+                id,
+                sender_id,
+                profiles:sender_id (display_name, unique_id)
+            `)
+            .eq('receiver_id', profile.id)
+            .eq('status', 'pending');
+
+        if (error) throw error;
+
+        spinner.stop();
+
+        if (requests.length === 0) {
+            console.log(hackerTheme.info('No pending requests.'));
+        } else {
+            const { requestAction } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'requestAction',
+                    message: hackerTheme.primary('PENDING REQUESTS:'),
+                    choices: [
+                        ...requests.map(r => ({
+                            name: `${r.profiles.display_name} (${r.profiles.unique_id})`,
+                            value: r
+                        })),
+                        { name: hackerTheme.error('[BACK] Main menu'), value: 'back' }
+                    ]
+                }
+            ]);
+
+            if (requestAction !== 'back') {
+                const { decision } = await inquirer.prompt([
+                    {
+                        type: 'list',
+                        name: 'decision',
+                        message: `Action for ${requestAction.profiles.display_name}:`,
+                        choices: [
+                            { name: hackerTheme.primary('[ACCEPT] Establish link'), value: 'accepted' },
+                            { name: hackerTheme.error('[REJECT] Deny access'), value: 'rejected' },
+                            { name: hackerTheme.system('[CANCEL] do nothing'), value: 'cancel' }
+                        ]
+                    }
+                ]);
+
+                if (decision !== 'cancel') {
+                    const { error: updateError } = await supabase
+                        .from('chat_requests')
+                        .update({ status: decision })
+                        .eq('id', requestAction.id);
+
+                    if (updateError) throw updateError;
+                    console.log(hackerTheme.primary(`Link status updated to: ${decision}`));
+                }
+            }
+        }
+    } catch (err) {
+        spinner.fail(hackerTheme.error(`Failed to manage requests: ${err.message}`));
+    }
+
+    await showMainMenu({ id: profile.id });
+}
+
+async function handleChats(profile) {
+    const spinner = ora(hackerTheme.info('Opening active channels...')).start();
+
+    try {
+        // Get accepted requests where user is sender or receiver
+        const { data: links, error } = await supabase
+            .from('chat_requests')
+            .select(`
+                id,
+                sender_id,
+                receiver_id,
+                sender:sender_id (id, display_name, unique_id),
+                receiver:receiver_id (id, display_name, unique_id)
+            `)
+            .or(`sender_id.eq.${profile.id},receiver_id.eq.${profile.id}`)
+            .eq('status', 'accepted');
+
+        if (error) throw error;
+
+        spinner.stop();
+
+        if (links.length === 0) {
+            console.log(hackerTheme.info('No active chats found. Find someone by ID first!'));
+        } else {
+            const { chat } = await inquirer.prompt([
+                {
+                    type: 'list',
+                    name: 'chat',
+                    message: hackerTheme.primary('ACTIVE CHANNELS:'),
+                    choices: [
+                        ...links.map(l => {
+                            const other = l.sender_id === profile.id ? l.receiver : l.sender;
+                            return { name: `${other.display_name} (${other.unique_id})`, value: other };
+                        }),
+                        { name: hackerTheme.error('[BACK] Main menu'), value: 'back' }
+                    ]
+                }
+            ]);
+
+            if (chat !== 'back') {
+                await startChat(profile, chat);
+            }
+        }
+    } catch (err) {
+        spinner.fail(hackerTheme.error(`Failed to load chats: ${err.message}`));
+    }
+
+    await showMainMenu({ id: profile.id });
+}
+
+async function startChat(me, other) {
+    clearConsole();
+    showBanner();
+    renderBox(`CONNECTION ESTABLISHED\nPEER: ${other.display_name}\nID: ${other.unique_id}\nSTATUS: ENCRYPTED`, 'SECURE_CHANNEL');
+    console.log(hackerTheme.system('Type "/help" for protocol list or "/exit" to disconnect.\n'));
+
+    // Fetch history
+    const { data: messages, error: fetchError } = await supabase
+        .from('messages')
+        .select('*')
+        .or(`and(sender_id.eq.${me.id},receiver_id.eq.${other.id}),and(sender_id.eq.${other.id},receiver_id.eq.${me.id})`)
+        .order('created_at', { ascending: true });
+
+    if (!fetchError) {
+        messages.forEach(msg => {
+            const label = msg.sender_id === me.id ? hackerTheme.primary('[YOU]') : hackerTheme.secondary(`[${other.display_name}]`);
+            console.log(`${label}: ${msg.content}`);
+        });
+    }
+
+    // Subscribe to new messages
+    const channel = supabase
+        .channel(`chat_${me.id}_${other.id}`)
+        .on('postgres_changes', { 
+            event: 'INSERT', 
+            schema: 'public', 
+            table: 'messages',
+            filter: `receiver_id=eq.${me.id}` 
+        }, payload => {
+            if (payload.new.sender_id === other.id) {
+                console.log(`${hackerTheme.secondary(`[${other.display_name}]`)}: ${payload.new.content}`);
+            }
+        })
+        .subscribe();
+
+    let active = true;
+    while (active) {
+        const { content } = await inquirer.prompt([
+            { type: 'input', name: 'content', message: hackerTheme.primary('>_ ') }
+        ]);
+
+        if (content.startsWith('/')) {
+            const cmd = content.split(' ')[0].toLowerCase();
+            switch (cmd) {
+                case '/exit':
+                    active = false;
+                    break;
+                case '/help':
+                    renderBox(
+                        '/help   - Show this manual\n' +
+                        '/clear  - Flush display buffer\n' +
+                        '/info   - Peer identity status\n' +
+                        '/shrug  - Inject ASCII shrug\n' +
+                        '/flip   - Table maneuver\n' +
+                        '/nuke   - Emergency disconnect',
+                        'COMMAND_PROTOCOLS'
+                    );
+                    break;
+                case '/clear':
+                    clearConsole();
+                    showBanner();
+                    renderBox(`PEER: ${other.display_name}\nID: ${other.unique_id}`, 'SESSION_RECOVERED');
+                    break;
+                case '/info':
+                    renderBox(`NAME: ${other.display_name}\nUID: ${other.unique_id}\nLINK_STABILITY: 100%`, 'PEER_INTEL');
+                    break;
+                case '/shrug':
+                    await sendMessage(me.id, other.id, '¯\\_(ツ)_/¯');
+                    break;
+                case '/flip':
+                    await sendMessage(me.id, other.id, '(╯°□°）╯︵ ┻━┻');
+                    break;
+                case '/nuke':
+                    await handleNuke();
+                    process.exit(0);
+                    break;
+                default:
+                    console.log(hackerTheme.error(`[SYSTEM] Invalid protocol: ${cmd}`));
+            }
+        } else if (content.trim()) {
+            await sendMessage(me.id, other.id, content);
+        }
+    }
+
+    supabase.removeChannel(channel);
+}
+
+async function sendMessage(senderId, receiverId, content) {
+    const { error: sendError } = await supabase
+        .from('messages')
+        .insert([{ sender_id: senderId, receiver_id: receiverId, content }]);
+
+    if (sendError) {
+        console.log(hackerTheme.error(`[ERROR] Transmission failed: ${sendError.message}`));
+    } else {
+        // Local echo for self messages if not handled by subscription (subscription only filters for receiver)
+        console.log(`${hackerTheme.primary('[YOU]')}: ${content}`);
+    }
+}
+
+async function handleNuke() {
+    const chars = '█▓▒░/\\<>#!?@$%^&*()';
+    const lines = 10;
+    for (let i = 0; i < lines; i++) {
+        let noise = '';
+        for (let j = 0; j < 50; j++) {
+            noise += chars[Math.floor(Math.random() * chars.length)];
+        }
+        console.log(hackerTheme.error(noise));
+        await SLEEP(50);
+    }
+    console.log(hackerTheme.error('\n!!! CRITICAL SYSTEM FAILURE: EMERGENCY SHUTDOWN INITIATED !!!\n'));
+    await SLEEP(500);
+}
+
+main();

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "keyline-cli",
+  "version": "1.0.0",
+  "description": "Secure Terminal Communication Protocol",
+  "main": "keyline.js",
+  "bin": {
+    "keyline": "./keyline.js"
+  },
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "cli",
+    "chat",
+    "secure",
+    "terminal"
+  ],
+  "author": "KeyLine Inc.",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "@supabase/supabase-js": "^2.39.1",
+    "chalk": "^4.1.2",
+    "dotenv": "^16.3.1",
+    "figlet": "^1.7.0",
+    "inquirer": "^8.2.6",
+    "nanoid": "^3.3.7",
+    "ora": "^5.4.1"
+  }
+}

package/update_schema.sql

@@ -0,0 +1 @@
+ALTER TABLE profiles ADD COLUMN IF NOT EXISTS chat_password TEXT;