holosphere 1.1.19 → 2.0.0-alpha0

package/bin/holosphere-activitypub.js

@@ -0,0 +1,158 @@
+#!/usr/bin/env node
+
+/**
+ * HoloSphere ActivityPub Server CLI
+ *
+ * Starts a self-hosted ActivityPub server for HoloSphere federation.
+ *
+ * Usage:
+ *   holosphere-activitypub [options]
+ *
+ * Options:
+ *   -p, --port <port>       Port to listen on (default: 3000)
+ *   -d, --domain <domain>   Domain name for federation (default: localhost)
+ *   --data-dir <dir>        Data directory for storage
+ *   --protocol <protocol>   Protocol: http or https (default: http)
+ *   -h, --help              Show this help message
+ *
+ * Environment Variables:
+ *   HOLOSPHERE_AP_PORT      Port to listen on
+ *   HOLOSPHERE_AP_DOMAIN    Domain name
+ *   HOLOSPHERE_AP_DATADIR   Data directory
+ *   HOLOSPHERE_AP_PROTOCOL  Protocol (http/https)
+ */
+
+import { ActivityPubServer } from '../src/storage/backends/activitypub/server.js';
+
+function parseArgs(args) {
+  const config = {
+    port: parseInt(process.env.HOLOSPHERE_AP_PORT) || 3000,
+    domain: process.env.HOLOSPHERE_AP_DOMAIN || 'localhost',
+    dataDir: process.env.HOLOSPHERE_AP_DATADIR,
+    protocol: process.env.HOLOSPHERE_AP_PROTOCOL || 'http',
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    const next = args[i + 1];
+
+    switch (arg) {
+      case '-p':
+      case '--port':
+        config.port = parseInt(next);
+        i++;
+        break;
+      case '-d':
+      case '--domain':
+        config.domain = next;
+        i++;
+        break;
+      case '--data-dir':
+        config.dataDir = next;
+        i++;
+        break;
+      case '--protocol':
+        config.protocol = next;
+        i++;
+        break;
+      case '-h':
+      case '--help':
+        showHelp();
+        process.exit(0);
+      default:
+        if (arg.startsWith('-')) {
+          console.error(`Unknown option: ${arg}`);
+          showHelp();
+          process.exit(1);
+        }
+    }
+  }
+
+  return config;
+}
+
+function showHelp() {
+  console.log(`
+HoloSphere ActivityPub Server
+
+Starts a self-hosted ActivityPub server for HoloSphere federation.
+This server can federate with Mastodon, Pleroma, and other ActivityPub servers.
+
+Usage:
+  holosphere-activitypub [options]
+
+Options:
+  -p, --port <port>       Port to listen on (default: 3000)
+  -d, --domain <domain>   Domain name for federation (default: localhost)
+  --data-dir <dir>        Data directory for persistent storage
+  --protocol <protocol>   Protocol: http or https (default: http)
+  -h, --help              Show this help message
+
+Environment Variables:
+  HOLOSPHERE_AP_PORT      Port to listen on
+  HOLOSPHERE_AP_DOMAIN    Domain name
+  HOLOSPHERE_AP_DATADIR   Data directory
+  HOLOSPHERE_AP_PROTOCOL  Protocol (http/https)
+
+Examples:
+  # Start server on default port
+  holosphere-activitypub
+
+  # Start server on port 8080 with custom domain
+  holosphere-activitypub -p 8080 -d myholosphere.example.com
+
+  # Start with persistent data directory
+  holosphere-activitypub --data-dir ./data --domain myserver.local
+
+Federation Notes:
+  For federation with other ActivityPub servers (Mastodon, etc.):
+  1. Your server must be accessible via the domain you specify
+  2. HTTPS is recommended for production federation
+  3. Set up proper DNS records pointing to your server
+  4. WebFinger discovery is available at /.well-known/webfinger
+`);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const config = parseArgs(args);
+
+  console.log('\n========================================');
+  console.log('  HoloSphere ActivityPub Server');
+  console.log('========================================');
+  console.log(`  Port:     ${config.port}`);
+  console.log(`  Domain:   ${config.domain}`);
+  console.log(`  Protocol: ${config.protocol}`);
+  console.log(`  Data Dir: ${config.dataDir || '(default)'}`);
+  console.log('========================================\n');
+
+  const server = new ActivityPubServer(config);
+
+  // Handle shutdown gracefully
+  process.on('SIGINT', () => {
+    console.log('\nShutting down...');
+    server.stop();
+    process.exit(0);
+  });
+
+  process.on('SIGTERM', () => {
+    console.log('\nShutting down...');
+    server.stop();
+    process.exit(0);
+  });
+
+  try {
+    await server.start();
+    console.log('\nServer endpoints:');
+    console.log(`  WebFinger:  ${config.protocol}://${config.domain}:${config.port}/.well-known/webfinger`);
+    console.log(`  Actors:     ${config.protocol}://${config.domain}:${config.port}/actor/{name}`);
+    console.log(`  API:        ${config.protocol}://${config.domain}:${config.port}/api/data`);
+    console.log(`  Health:     ${config.protocol}://${config.domain}:${config.port}/health`);
+    console.log('\nPress Ctrl+C to stop the server\n');
+  } catch (error) {
+    console.error('Failed to start server:', error);
+    process.exit(1);
+  }
+}
+
+main();

package/cleanup-test-data.js

@@ -0,0 +1,204 @@
+/**
+ * Cleanup Test Data from Relays
+ *
+ * This script finds and deletes test data published to relays
+ * It uses tombstone deletion (Nostr standard) to mark events as deleted
+ */
+
+import { HoloSphere } from './dist/esm/holosphere.js';
+
+// Relay configuration - use env vars or these defaults
+const RELAYS = process.env.HOLOSPHERE_RELAYS?.split(',') || [
+  'wss://relay.holons.io',
+  'wss://relay.nostr.band',
+];
+
+const c = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m'
+};
+
+function log(msg, color = 'reset') {
+  console.log(`${c[color]}${msg}${c.reset}`);
+}
+
+console.log('\n╔═══════════════════════════════════════════════════════════════════╗');
+log('║              HOLOSPHERE TEST DATA CLEANUP UTILITY                 ║', 'cyan');
+console.log('╚═══════════════════════════════════════════════════════════════════╝\n');
+
+// Test app names to clean up
+const TEST_APPS = [
+  'permanence-test',
+  'debug-test',
+  'simple-test',
+  'relay-permanence-test',
+  'HolonsDebug'
+];
+
+log('This script will delete test data from the following apps:', 'yellow');
+TEST_APPS.forEach(app => log(`  • ${app}`, 'blue'));
+
+log('\n⚠️  Note: Deletion in Nostr is done by publishing tombstone events.', 'yellow');
+log('    Old events may still exist on relays but will be marked as deleted.\n', 'yellow');
+
+// Function to clean up a specific app
+async function cleanupApp(appName) {
+  log(`\n${'─'.repeat(70)}`, 'cyan');
+  log(`Cleaning up: ${appName}`, 'cyan');
+  log('─'.repeat(70), 'cyan');
+
+  try {
+    const hs = new HoloSphere({
+      appName: appName,
+      relays: RELAYS,
+      logLevel: 'WARN'
+    });
+
+    log(`Public Key: ${hs.client.publicKey}`, 'blue');
+
+    // Wait for connections
+    await new Promise(resolve => setTimeout(resolve, 2000));
+
+    // Query all events for this app
+    log('\nQuerying events...', 'yellow');
+
+    const filter = {
+      kinds: [30000],
+      authors: [hs.client.publicKey],
+      limit: 1000
+    };
+
+    const events = await hs.client.query(filter, { timeout: 5000 });
+
+    // Filter to only this app's events
+    const appEvents = events.filter(event => {
+      const dTag = event.tags.find(t => t[0] === 'd');
+      return dTag && dTag[1] && dTag[1].startsWith(appName + '/');
+    });
+
+    log(`Found ${appEvents.length} events for ${appName}`, 'blue');
+
+    if (appEvents.length === 0) {
+      log('No events to clean up', 'green');
+      return { deleted: 0, failed: 0 };
+    }
+
+    // Show sample of events
+    log('\nSample events:', 'yellow');
+    appEvents.slice(0, 5).forEach((event, i) => {
+      const dTag = event.tags.find(t => t[0] === 'd');
+      log(`  ${i + 1}. ${dTag[1]}`, 'blue');
+    });
+    if (appEvents.length > 5) {
+      log(`  ... and ${appEvents.length - 5} more`, 'blue');
+    }
+
+    log('\nDeleting events...', 'yellow');
+
+    let deleted = 0;
+    let failed = 0;
+
+    // Import storage utilities
+    const { nostrPut } = await import('./src/storage/nostr-async.js');
+
+    for (const event of appEvents) {
+      const dTag = event.tags.find(t => t[0] === 'd');
+      if (!dTag) continue;
+
+      const path = dTag[1];
+
+      try {
+        // Create tombstone
+        const tombstone = {
+          _deleted: true,
+          _deletedAt: Date.now(),
+          _cleanedUp: true
+        };
+
+        const result = await nostrPut(hs.client, path, tombstone);
+        const success = result.results.some(r => r.status === 'fulfilled');
+
+        if (success) {
+          deleted++;
+          log(`  ✓ Deleted: ${path}`, 'green');
+        } else {
+          failed++;
+          log(`  ✗ Failed: ${path}`, 'red');
+        }
+      } catch (error) {
+        failed++;
+        log(`  ✗ Error deleting ${path}: ${error.message}`, 'red');
+      }
+
+      // Rate limit to avoid overwhelming relays
+      await new Promise(resolve => setTimeout(resolve, 100));
+    }
+
+    log(`\n✓ Cleanup complete for ${appName}`, 'green');
+    log(`  Deleted: ${deleted}`, 'green');
+    log(`  Failed: ${failed}`, failed > 0 ? 'red' : 'green');
+
+    return { deleted, failed };
+
+  } catch (error) {
+    log(`\n✗ Error cleaning up ${appName}: ${error.message}`, 'red');
+    return { deleted: 0, failed: 1 };
+  }
+}
+
+// Main cleanup function
+async function cleanup() {
+  const results = {
+    totalDeleted: 0,
+    totalFailed: 0,
+    apps: []
+  };
+
+  for (const app of TEST_APPS) {
+    const result = await cleanupApp(app);
+    results.totalDeleted += result.deleted;
+    results.totalFailed += result.failed;
+    results.apps.push({ app, ...result });
+  }
+
+  // Summary
+  log('\n' + '═'.repeat(70), 'cyan');
+  log('  CLEANUP SUMMARY', 'cyan');
+  log('═'.repeat(70), 'cyan');
+
+  results.apps.forEach(({ app, deleted, failed }) => {
+    if (deleted > 0 || failed > 0) {
+      log(`\n${app}:`, 'blue');
+      log(`  Deleted: ${deleted}`, 'green');
+      if (failed > 0) log(`  Failed: ${failed}`, 'red');
+    }
+  });
+
+  log(`\nTotal Deleted: ${results.totalDeleted}`, 'green');
+  if (results.totalFailed > 0) {
+    log(`Total Failed: ${results.totalFailed}`, 'red');
+  }
+
+  if (results.totalDeleted === 0) {
+    log('\n✓ No test data found to clean up', 'green');
+  } else {
+    log('\n✓ Test data cleanup complete!', 'green');
+  }
+
+  log('\n');
+}
+
+// Run cleanup
+cleanup()
+  .then(() => {
+    setTimeout(() => process.exit(0), 1000);
+  })
+  .catch(error => {
+    log(`\n✗ Fatal error: ${error.message}`, 'red');
+    console.error(error);
+    process.exit(1);
+  });