phonepod 0.0.1

package/README.md

@@ -0,0 +1,88 @@
+# PhonePod
+
+Solid pod on your phone. One command install for Android/Termux.
+
+## Features
+
+- **Solid Pod** - Full LDP server with WebID, WAC
+- **Nostr Relay** - Built-in NIP-01 relay
+- **Git Server** - Clone and push via HTTP
+- **~100MB RAM** - Lighter than a browser tab
+
+## Quick Install (Termux)
+
+```bash
+pkg install nodejs-lts
+npm install -g phonepod
+phonepod start
+```
+
+## Usage
+
+```bash
+phonepod start              # Start the pod
+phonepod start --port 3000  # Custom port
+phonepod tunnel user@host   # Setup SSH tunnel for public access
+phonepod status             # Show configuration
+```
+
+## Public Access
+
+To make your pod publicly accessible, you need a relay server:
+
+```bash
+# Setup tunnel (generates SSH key, creates tunnel script)
+phonepod tunnel ubuntu@relay.example.com
+
+# Add the printed SSH key to your relay server
+# Then start tunnel with PM2:
+pm2 start ~/.phonepod/tunnel.sh --name tunnel
+pm2 save
+```
+
+## Boot Persistence
+
+Install Termux:Boot from F-Droid, then:
+
+```bash
+mkdir -p ~/.termux/boot
+echo '#!/bin/bash
+termux-wake-lock
+pm2 resurrect' > ~/.termux/boot/start.sh
+chmod +x ~/.termux/boot/start.sh
+
+# Save current processes
+pm2 start phonepod -- start
+pm2 save
+```
+
+## Endpoints
+
+| Endpoint | Description |
+|----------|-------------|
+| `http://localhost:8080/` | Solid pod root |
+| `ws://localhost:8080/relay` | Nostr relay |
+| `http://localhost:8080/relay/info` | NIP-11 relay info |
+| `git clone http://localhost:8080/` | Git clone |
+
+## Configuration
+
+Config stored in `~/.phonepod/config.json`:
+
+```json
+{
+  "port": 8080,
+  "nostr": true,
+  "git": true
+}
+```
+
+## Requirements
+
+- Android with Termux
+- Node.js 18+
+- For public access: relay server with SSH access
+
+## License
+
+MIT

package/bin/phonepod.js

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+
+/**
+ * PhonePod CLI
+ *
+ * Solid pod on your phone - Android/Termux
+ *
+ * Usage:
+ *   phonepod start [options]   Start the pod
+ *   phonepod setup             Interactive setup
+ *   phonepod tunnel <host>     Setup SSH tunnel to relay
+ *   phonepod status            Show status
+ */
+
+import { spawn } from 'child_process';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+import { createInterface } from 'readline';
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// Config directory
+const CONFIG_DIR = join(homedir(), '.phonepod');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+// Ensure config dir exists
+if (!existsSync(CONFIG_DIR)) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+}
+
+// Load or create config
+function loadConfig() {
+  if (existsSync(CONFIG_FILE)) {
+    return JSON.parse(readFileSync(CONFIG_FILE, 'utf8'));
+  }
+  return { port: 8080, nostr: true, git: true };
+}
+
+function saveConfig(config) {
+  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+
+// Run JSS with phonepod defaults
+function startPod(options = {}) {
+  const config = loadConfig();
+  const jssArgs = [
+    'start',
+    '--port', String(options.port || config.port || 8080),
+  ];
+
+  if (options.nostr ?? config.nostr) jssArgs.push('--nostr');
+  if (options.git ?? config.git) jssArgs.push('--git');
+  if (options.root) jssArgs.push('--root', options.root);
+
+  console.log('Starting PhonePod...');
+  console.log(`  Port: ${options.port || config.port || 8080}`);
+  console.log(`  Nostr: ${(options.nostr ?? config.nostr) ? 'enabled' : 'disabled'}`);
+  console.log(`  Git: ${(options.git ?? config.git) ? 'enabled' : 'disabled'}`);
+  console.log('');
+
+  // Find jss binary
+  const jss = spawn('jss', jssArgs, { stdio: 'inherit' });
+
+  jss.on('error', (err) => {
+    if (err.code === 'ENOENT') {
+      console.error('Error: jss not found. Run: npm install -g javascript-solid-server');
+    } else {
+      console.error('Error:', err.message);
+    }
+    process.exit(1);
+  });
+
+  jss.on('exit', (code) => process.exit(code || 0));
+}
+
+// Setup tunnel
+async function setupTunnel(relayHost) {
+  if (!relayHost) {
+    console.error('Usage: phonepod tunnel <relay-host>');
+    console.error('Example: phonepod tunnel relay.example.com');
+    process.exit(1);
+  }
+
+  const config = loadConfig();
+  const port = config.port || 8080;
+
+  console.log('');
+  console.log('Setting up SSH tunnel to', relayHost);
+  console.log('');
+
+  // Check for SSH key
+  const sshKeyPath = join(homedir(), '.ssh', 'id_ed25519');
+  const sshPubKeyPath = sshKeyPath + '.pub';
+
+  if (!existsSync(sshKeyPath)) {
+    console.log('Generating SSH key...');
+    const keygen = spawn('ssh-keygen', ['-t', 'ed25519', '-f', sshKeyPath, '-N', ''], { stdio: 'inherit' });
+    await new Promise(resolve => keygen.on('exit', resolve));
+  }
+
+  // Show public key
+  if (existsSync(sshPubKeyPath)) {
+    const pubKey = readFileSync(sshPubKeyPath, 'utf8').trim();
+    console.log('');
+    console.log('Add this SSH key to your relay server:');
+    console.log('');
+    console.log(pubKey);
+    console.log('');
+  }
+
+  // Create tunnel script
+  const tunnelScript = join(CONFIG_DIR, 'tunnel.sh');
+  writeFileSync(tunnelScript, `#!/bin/bash
+exec autossh -M 0 -o ServerAliveInterval=30 -o ServerAliveCountMax=3 -N -R ${port}:localhost:${port} ${relayHost}
+`);
+  spawn('chmod', ['+x', tunnelScript]);
+
+  console.log(`Tunnel script created: ${tunnelScript}`);
+  console.log('');
+  console.log('To start tunnel manually:');
+  console.log(`  ${tunnelScript}`);
+  console.log('');
+  console.log('To add to PM2:');
+  console.log(`  pm2 start ${tunnelScript} --name tunnel`);
+  console.log('  pm2 save');
+  console.log('');
+
+  // Save relay host to config
+  config.relayHost = relayHost;
+  saveConfig(config);
+}
+
+// Show status
+function showStatus() {
+  const config = loadConfig();
+  console.log('');
+  console.log('PhonePod Configuration:');
+  console.log('');
+  console.log(`  Port:   ${config.port || 8080}`);
+  console.log(`  Nostr:  ${config.nostr ? 'enabled' : 'disabled'}`);
+  console.log(`  Git:    ${config.git ? 'enabled' : 'disabled'}`);
+  if (config.relayHost) {
+    console.log(`  Relay:  ${config.relayHost}`);
+  }
+  console.log('');
+  console.log(`  Config: ${CONFIG_FILE}`);
+  console.log('');
+}
+
+// Help
+function showHelp() {
+  console.log(`
+PhonePod - Solid pod on your phone
+
+Usage:
+  phonepod start [options]   Start the pod
+  phonepod tunnel <host>     Setup SSH tunnel to relay
+  phonepod status            Show configuration
+  phonepod help              Show this help
+
+Start Options:
+  --port <n>                 Port to listen on (default: 8080)
+  --no-nostr                 Disable Nostr relay
+  --no-git                   Disable Git server
+
+Examples:
+  phonepod start
+  phonepod start --port 3000
+  phonepod tunnel ubuntu@relay.example.com
+`);
+}
+
+// Parse start options
+function parseStartOptions() {
+  const options = {};
+  for (let i = 1; i < args.length; i++) {
+    if (args[i] === '--port' && args[i + 1]) {
+      options.port = parseInt(args[++i], 10);
+    } else if (args[i] === '--no-nostr') {
+      options.nostr = false;
+    } else if (args[i] === '--no-git') {
+      options.git = false;
+    } else if (args[i] === '--root' && args[i + 1]) {
+      options.root = args[++i];
+    }
+  }
+  return options;
+}
+
+// Main
+switch (command) {
+  case 'start':
+    startPod(parseStartOptions());
+    break;
+  case 'tunnel':
+    setupTunnel(args[1]);
+    break;
+  case 'status':
+    showStatus();
+    break;
+  case 'help':
+  case '--help':
+  case '-h':
+    showHelp();
+    break;
+  default:
+    if (command) {
+      console.error(`Unknown command: ${command}`);
+    }
+    showHelp();
+    process.exit(command ? 1 : 0);
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "phonepod",
+  "version": "0.0.1",
+  "description": "Solid pod on your phone - one command install for Android/Termux",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "phonepod": "./bin/phonepod.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\""
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JavaScriptSolidServer/phonepod.git"
+  },
+  "keywords": [
+    "solid",
+    "pod",
+    "phone",
+    "android",
+    "termux",
+    "nostr",
+    "decentralized"
+  ],
+  "author": "",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/JavaScriptSolidServer/phonepod/issues"
+  },
+  "homepage": "https://github.com/JavaScriptSolidServer/phonepod#readme",
+  "dependencies": {
+    "javascript-solid-server": "^0.0.60"
+  }
+}