fedbox 0.0.1 → 0.0.4

package/QUICKSTART.md

@@ -0,0 +1,90 @@
+# Fedbox Quickstart
+
+Clean slate setup with ngrok federation.
+
+## 1. Clean existing data
+
+```bash
+# Remove database only
+fedbox clean
+
+# Remove everything (database + config + keys)
+fedbox clean --all
+```
+
+## 2. Initialize
+
+```bash
+fedbox init
+```
+
+Prompts for: username, display name, bio, port (default 3000).
+
+Creates `fedbox.json` with generated keypair.
+
+## 3. Start server
+
+```bash
+fedbox start
+```
+
+Server runs at `http://localhost:3000/{username}`
+
+## 4. Expose with ngrok
+
+In another terminal:
+
+```bash
+ngrok http 3000
+```
+
+Copy the https URL (e.g., `https://abc123.ngrok-free.app`)
+
+## 5. Configure domain
+
+Edit `fedbox.json`, add domain (without https://):
+
+```json
+{
+  "domain": "abc123.ngrok-free.app",
+  ...
+}
+```
+
+Restart server (`Ctrl+C`, then `fedbox start`).
+
+## 6. Test federation
+
+From Mastodon, search for `@{username}@{domain}`
+
+## 7. Post something
+
+```bash
+fedbox post "Hello, Fediverse!"
+```
+
+## URI Structure (Solid-compatible)
+
+| URI | Purpose |
+|-----|---------|
+| `/{username}` | Profile (HTML + JSON-LD) |
+| `/{username}#me` | WebID (Actor ID) |
+| `/{username}/inbox` | Inbox |
+| `/{username}/outbox` | Outbox |
+| `/{username}/posts/{id}` | Individual post |
+| `/{username}#main-key` | Public key |
+
+## All Commands
+
+```
+fedbox init              # Setup identity
+fedbox start             # Start server
+fedbox status            # Show config
+fedbox post "text"       # Post to followers
+fedbox follow @user@dom  # Follow someone
+fedbox timeline          # View feed
+fedbox reply <url> "text"# Reply to post
+fedbox posts             # View own posts
+fedbox clean             # Remove database
+fedbox clean --all       # Remove everything
+```

package/README.md

@@ -15,10 +15,32 @@ fedbox init
 
 # Start your server
 fedbox start
+
+# Post something!
+fedbox post "Hello, Fediverse!"
 ```
 
 That's it. You're on the Fediverse.
 
+## Commands
+
+```bash
+# Setup
+fedbox init           # Set up your identity
+fedbox start          # Start the server
+fedbox status         # Show your profile info
+
+# Social
+fedbox post "text"    # Post a message to followers
+fedbox follow @user@domain  # Follow someone
+fedbox timeline       # View posts from people you follow
+fedbox reply <url> "text"   # Reply to a post
+fedbox posts          # View your own posts
+
+# Help
+fedbox help           # Show all commands
+```
+
 ## Federation (so Mastodon can find you)
 
 To federate with the wider Fediverse, you need a public HTTPS URL. The easiest way:
@@ -42,28 +64,25 @@ Restart your server, and you're federated! Search for `@yourname@abc123.ngrok.io
 ## What You Get
 
 - **Your own identity** — `@you@yourdomain.com`
+- **Post from CLI** — `fedbox post "Hello world"`
+- **Follow anyone** — `fedbox follow @user@mastodon.social`
+- **View timeline** — `fedbox timeline`
+- **Reply to posts** — `fedbox reply <url> "Nice!"`
 - **ActivityPub compatible** — Works with Mastodon, Pleroma, Pixelfed, etc.
-- **Persistent storage** — SQLite database for followers, posts, activities
-- **Beautiful profile page** — Dark theme, looks great
-- **Zero config** — Just answer a few questions
-
-## Commands
-
-```bash
-fedbox init     # Set up your identity
-fedbox start    # Start the server
-fedbox status   # Show current config
-fedbox help     # Show help
-```
+- **HTTP Signature verification** — Secure federation
+- **Rate limiting** — Protection against abuse
+- **Persistent storage** — SQLite database
+- **Beautiful profile page** — Dark theme, shows your posts
 
 ## How It Works
 
 Fedbox uses [microfed](https://github.com/micro-fed/microfed.org) for ActivityPub primitives:
 
 - **Profile** — Your actor/identity
-- **Inbox** — Receive follows, likes, boosts
+- **Inbox** — Receive follows, likes, boosts, posts
 - **Outbox** — Your posts
 - **WebFinger** — So others can find you
+- **HTTP Signatures** — Secure signed requests
 
 Data is stored in SQLite (`data/fedbox.db`).
 

package/bin/cli.js

@@ -1,13 +1,12 @@
 #!/usr/bin/env node
 
 /**
- * Pubcrawl CLI
+ * Fedbox CLI
  * Zero to Fediverse in 60 seconds
  */
 
 import { createInterface } from 'readline'
-import { existsSync, writeFileSync, mkdirSync } from 'fs'
-import { join } from 'path'
+import { existsSync, writeFileSync, mkdirSync, readFileSync, unlinkSync, rmSync } from 'fs'
 import { generateKeypair } from 'microfed/auth'
 
 const rl = createInterface({
@@ -30,6 +29,12 @@ const COMMANDS = {
   init: runInit,
   start: runStart,
   status: runStatus,
+  post: runPost,
+  follow: runFollow,
+  timeline: runTimeline,
+  reply: runReply,
+  posts: runPosts,
+  clean: runClean,
   help: runHelp
 }
 
@@ -49,7 +54,6 @@ async function main() {
 async function runInit() {
   console.log(BANNER)
 
-  // Check if already initialized
   if (existsSync('fedbox.json')) {
     console.log('⚠️  Already initialized. Delete fedbox.json to start over.\n')
     process.exit(1)
@@ -57,7 +61,6 @@ async function runInit() {
 
   console.log('Let\'s get you on the Fediverse!\n')
 
-  // Gather info
   const username = await ask('👤 Username (e.g., alice): ')
   const displayName = await ask('📛 Display name (e.g., Alice): ') || username
   const summary = await ask('📝 Bio (optional): ') || ''
@@ -66,7 +69,6 @@ async function runInit() {
   console.log('\n🔐 Generating keypair...')
   const { publicKey, privateKey } = generateKeypair()
 
-  // Create config
   const config = {
     username: username.toLowerCase().replace(/[^a-z0-9]/g, ''),
     displayName,
@@ -77,12 +79,10 @@ async function runInit() {
     createdAt: new Date().toISOString()
   }
 
-  // Create data directory
   if (!existsSync('data')) {
     mkdirSync('data')
   }
 
-  // Save config
   writeFileSync('fedbox.json', JSON.stringify(config, null, 2))
   console.log('✅ Config saved to fedbox.json')
 
@@ -118,7 +118,6 @@ async function runStart() {
 
   console.log('🚀 Starting server...\n')
 
-  // Dynamic import to avoid loading before init
   const { startServer } = await import('../lib/server.js')
   await startServer()
 }
@@ -129,39 +128,269 @@ async function runStatus() {
     process.exit(1)
   }
 
-  const config = JSON.parse(await import('fs').then(fs =>
-    fs.readFileSync('fedbox.json', 'utf8')
-  ))
+  const config = JSON.parse(readFileSync('fedbox.json', 'utf8'))
+
+  // Get follower/following counts
+  let followers = 0, following = 0
+  try {
+    const { initStore, getFollowerCount, getFollowingCount } = await import('../lib/store.js')
+    initStore()
+    followers = getFollowerCount()
+    following = getFollowingCount()
+  } catch {}
 
   console.log(`
 ╔═══════════════════════════════════════════╗
 ║  📊 FEDBOX STATUS                         ║
 ╚═══════════════════════════════════════════╝
 
-Username:  @${config.username}
-Name:      ${config.displayName}
-Port:      ${config.port}
-Domain:    ${config.domain || '(not set - run with ngrok)'}
-Created:   ${config.createdAt}
+Username:   @${config.username}
+Name:       ${config.displayName}
+Port:       ${config.port}
+Domain:     ${config.domain || '(not set - run with ngrok)'}
+Followers:  ${followers}
+Following:  ${following}
+Created:    ${config.createdAt}
+`)
+
+  rl.close()
+}
+
+async function runPost() {
+  if (!existsSync('fedbox.json')) {
+    console.log('❌ Not initialized. Run: fedbox init\n')
+    process.exit(1)
+  }
+
+  const content = process.argv[3]
+  if (!content) {
+    console.log('Usage: fedbox post "Your message here"')
+    process.exit(1)
+  }
+
+  const { post } = await import('../lib/actions.js')
+
+  console.log('📝 Creating post...')
+  const result = await post(content)
+
+  console.log(`
+✅ Posted!
+
+ID: ${result.noteId}
+Content: ${content}
+Delivered to: ${result.delivered.success} followers (${result.delivered.failed} failed)
+`)
+
+  rl.close()
+}
+
+async function runFollow() {
+  if (!existsSync('fedbox.json')) {
+    console.log('❌ Not initialized. Run: fedbox init\n')
+    process.exit(1)
+  }
+
+  const handle = process.argv[3]
+  if (!handle) {
+    console.log('Usage: fedbox follow @user@domain')
+    process.exit(1)
+  }
+
+  const { follow } = await import('../lib/actions.js')
+
+  try {
+    const result = await follow(handle)
+    console.log(`
+✅ Follow request sent!
+
+User: ${result.actor.preferredUsername || result.actor.name}
+Actor: ${result.actor.id}
+
+Waiting for them to accept...
+`)
+  } catch (err) {
+    console.log(`❌ ${err.message}`)
+    process.exit(1)
+  }
+
+  rl.close()
+}
+
+async function runTimeline() {
+  if (!existsSync('fedbox.json')) {
+    console.log('❌ Not initialized. Run: fedbox init\n')
+    process.exit(1)
+  }
+
+  const { timeline } = await import('../lib/actions.js')
+  const posts = timeline(20)
+
+  if (posts.length === 0) {
+    console.log(`
+📭 Your timeline is empty.
+
+Follow some people with: fedbox follow @user@domain
+`)
+    rl.close()
+    return
+  }
+
+  console.log(`
+╔═══════════════════════════════════════════╗
+║  📰 TIMELINE                              ║
+╚═══════════════════════════════════════════╝
+`)
+
+  for (const post of posts) {
+    const author = post.author?.split('/').pop() || 'unknown'
+    const content = post.content
+      .replace(/<[^>]*>/g, '') // Strip HTML
+      .slice(0, 200)
+    const date = new Date(post.published).toLocaleString()
+
+    console.log(`┌─ @${author} · ${date}`)
+    console.log(`│ ${content}`)
+    if (post.inReplyTo) {
+      console.log(`│ ↩️  Reply to: ${post.inReplyTo}`)
+    }
+    console.log(`└─ ${post.id}`)
+    console.log()
+  }
+
+  rl.close()
+}
+
+async function runReply() {
+  if (!existsSync('fedbox.json')) {
+    console.log('❌ Not initialized. Run: fedbox init\n')
+    process.exit(1)
+  }
+
+  const postUrl = process.argv[3]
+  const content = process.argv[4]
+
+  if (!postUrl || !content) {
+    console.log('Usage: fedbox reply <post-url> "Your reply"')
+    process.exit(1)
+  }
+
+  const { reply } = await import('../lib/actions.js')
+
+  console.log('💬 Sending reply...')
+  const result = await reply(postUrl, content)
+
+  console.log(`
+✅ Reply sent!
+
+ID: ${result.noteId}
+In reply to: ${postUrl}
+Delivered to: ${result.delivered.success} inboxes
 `)
 
   rl.close()
 }
 
+async function runPosts() {
+  if (!existsSync('fedbox.json')) {
+    console.log('❌ Not initialized. Run: fedbox init\n')
+    process.exit(1)
+  }
+
+  const { myPosts } = await import('../lib/actions.js')
+  const posts = myPosts(20)
+
+  if (posts.length === 0) {
+    console.log(`
+📭 You haven't posted anything yet.
+
+Create a post with: fedbox post "Hello, Fediverse!"
+`)
+    rl.close()
+    return
+  }
+
+  console.log(`
+╔═══════════════════════════════════════════╗
+║  📝 YOUR POSTS                            ║
+╚═══════════════════════════════════════════╝
+`)
+
+  for (const post of posts) {
+    const date = new Date(post.published).toLocaleString()
+    console.log(`┌─ ${date}`)
+    console.log(`│ ${post.content}`)
+    if (post.in_reply_to) {
+      console.log(`│ ↩️  Reply to: ${post.in_reply_to}`)
+    }
+    console.log(`└─ ${post.id}`)
+    console.log()
+  }
+
+  rl.close()
+}
+
+async function runClean() {
+  const all = process.argv[3] === '--all'
+
+  console.log('🧹 Cleaning up...\n')
+
+  // Remove database
+  if (existsSync('data/fedbox.db')) {
+    unlinkSync('data/fedbox.db')
+    console.log('   ✓ Removed data/fedbox.db')
+  }
+
+  // Remove data directory if empty
+  if (existsSync('data')) {
+    try {
+      rmSync('data', { recursive: false })
+      console.log('   ✓ Removed data/')
+    } catch {
+      // Directory not empty, that's ok
+    }
+  }
+
+  // Remove config if --all
+  if (all && existsSync('fedbox.json')) {
+    unlinkSync('fedbox.json')
+    console.log('   ✓ Removed fedbox.json')
+  }
+
+  console.log('\n✅ Clean complete!')
+
+  if (!all) {
+    console.log('\n   Tip: Use "fedbox clean --all" to also remove config')
+  }
+
+  rl.close()
+}
+
 function runHelp() {
   console.log(`
 ${BANNER}
-Usage: fedbox <command>
+Usage: fedbox <command> [args]
+
+Setup:
+  init              Set up a new Fediverse identity
+  start             Start the server
+  status            Show current configuration
+
+Social:
+  post "text"       Post a message to your followers
+  follow @user@dom  Follow a remote user
+  timeline          View posts from people you follow
+  reply <url> "text" Reply to a post
+  posts             View your own posts
 
-Commands:
-  init      Set up a new Fediverse identity
-  start     Start the server
-  status    Show current configuration
-  help      Show this help
+Other:
+  clean             Remove database (add --all to also remove config)
+  help              Show this help
 
 Quick start:
   $ fedbox init
   $ fedbox start
+  $ fedbox post "Hello, Fediverse!"
+  $ fedbox follow @user@mastodon.social
 
 For federation (so Mastodon can find you):
   $ ngrok http 3000