@portel/photon 1.4.1 → 1.6.0

package/dist/cli/commands/marketplace.js

@@ -0,0 +1,198 @@
+/**
+ * Marketplace CLI Commands
+ *
+ * Manage MCP marketplaces (list, add, remove, enable, disable)
+ */
+import { getErrorMessage } from '../../shared/error-handler.js';
+import { Logger } from '../../shared/logger.js';
+const logger = new Logger({ component: 'marketplace' });
+/**
+ * Register marketplace subcommands
+ */
+export function registerMarketplaceCommands(program) {
+    const marketplace = program.command('marketplace').description('Manage photon marketplaces');
+    marketplace
+        .command('list')
+        .description('List all configured marketplaces')
+        .action(async () => {
+        try {
+            const { MarketplaceManager } = await import('../../marketplace-manager.js');
+            const { formatOutput, printInfo, STATUS } = await import('../../cli-formatter.js');
+            const manager = new MarketplaceManager();
+            await manager.initialize();
+            const marketplaces = manager.getAll();
+            if (marketplaces.length === 0) {
+                printInfo('No marketplaces configured');
+                printInfo('Add one with: photon marketplace add portel-dev/photons');
+                return;
+            }
+            // Get MCP counts
+            const counts = await manager.getMarketplaceCounts();
+            // Build table data
+            const tableData = marketplaces.map((m) => ({
+                name: m.name,
+                source: m.source || m.repo || '-',
+                photons: counts.get(m.name) || 0,
+                status: m.enabled ? STATUS.OK : STATUS.OFF,
+            }));
+            printInfo(`Configured marketplaces (${marketplaces.length}):\n`);
+            formatOutput(tableData, 'table');
+        }
+        catch (error) {
+            const { printError } = await import('../../cli-formatter.js');
+            printError(getErrorMessage(error));
+            process.exit(1);
+        }
+    });
+    marketplace
+        .command('add')
+        .argument('<repo>', 'GitHub repository (username/repo or github.com URL)')
+        .description('Add a new MCP marketplace from GitHub')
+        .action(async (repo) => {
+        try {
+            const { MarketplaceManager } = await import('../../marketplace-manager.js');
+            const manager = new MarketplaceManager();
+            await manager.initialize();
+            const { marketplace: result, added } = await manager.add(repo);
+            if (added) {
+                console.error(`✅ Added marketplace: ${result.name}`);
+                console.error(`Source: ${repo}`);
+                console.error(`URL: ${result.url}`);
+                // Auto-fetch marketplace.json
+                console.error(`Fetching marketplace metadata...`);
+                const success = await manager.updateMarketplaceCache(result.name);
+                if (success) {
+                    console.error(`✅ Marketplace ready to use`);
+                }
+            }
+            else {
+                console.error(`ℹ️  Marketplace already exists: ${result.name}`);
+                console.error(`Source: ${result.source}`);
+                console.error(`Skipping duplicate addition`);
+            }
+        }
+        catch (error) {
+            logger.error(`Error: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+    marketplace
+        .command('remove')
+        .argument('<name>', 'Marketplace name')
+        .description('Remove a marketplace')
+        .action(async (name) => {
+        try {
+            const { MarketplaceManager } = await import('../../marketplace-manager.js');
+            const manager = new MarketplaceManager();
+            await manager.initialize();
+            const removed = await manager.remove(name);
+            if (removed) {
+                console.error(`✅ Removed marketplace: ${name}`);
+            }
+            else {
+                logger.error(`Marketplace '${name}' not found`);
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            logger.error(`Error: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+    marketplace
+        .command('enable')
+        .argument('<name>', 'Marketplace name')
+        .description('Enable a marketplace')
+        .action(async (name) => {
+        try {
+            const { MarketplaceManager } = await import('../../marketplace-manager.js');
+            const manager = new MarketplaceManager();
+            await manager.initialize();
+            const success = await manager.setEnabled(name, true);
+            if (success) {
+                console.error(`✅ Enabled marketplace: ${name}`);
+            }
+            else {
+                logger.error(`Marketplace '${name}' not found`);
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            logger.error(`Error: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+    marketplace
+        .command('disable')
+        .argument('<name>', 'Marketplace name')
+        .description('Disable a marketplace')
+        .action(async (name) => {
+        try {
+            const { MarketplaceManager } = await import('../../marketplace-manager.js');
+            const manager = new MarketplaceManager();
+            await manager.initialize();
+            const success = await manager.setEnabled(name, false);
+            if (success) {
+                console.error(`✅ Disabled marketplace: ${name}`);
+            }
+            else {
+                logger.error(`Marketplace '${name}' not found`);
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            logger.error(`Error: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+    marketplace
+        .command('update')
+        .argument('[name]', 'Marketplace name (optional, updates all if omitted)')
+        .description('Update marketplace cache (fetch latest photon list)')
+        .action(async (name) => {
+        try {
+            const { MarketplaceManager } = await import('../../marketplace-manager.js');
+            const manager = new MarketplaceManager();
+            await manager.initialize();
+            if (name) {
+                // Update specific marketplace
+                const marketplace = manager.get(name);
+                if (!marketplace) {
+                    logger.error(`Marketplace '${name}' not found`);
+                    process.exit(1);
+                }
+                console.error(`Updating ${name}...`);
+                const success = await manager.updateMarketplaceCache(name);
+                if (success) {
+                    console.error(`✅ Updated marketplace: ${name}`);
+                }
+                else {
+                    console.error(`⚠️  Failed to update marketplace: ${name}`);
+                }
+            }
+            else {
+                // Update all enabled marketplaces
+                console.error(`Updating all enabled marketplaces...`);
+                const results = await manager.updateAllCaches();
+                let successCount = 0;
+                let failCount = 0;
+                for (const [marketplaceName, success] of results) {
+                    if (success) {
+                        console.error(`  ✅ ${marketplaceName}`);
+                        successCount++;
+                    }
+                    else {
+                        console.error(`  ⚠️  ${marketplaceName} (failed)`);
+                        failCount++;
+                    }
+                }
+                console.error(`\nUpdated ${successCount} marketplace(s)${failCount > 0 ? `, ${failCount} failed` : ''}`);
+            }
+        }
+        catch (error) {
+            logger.error(`Error: ${getErrorMessage(error)}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/cli/commands/marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.js","sourceRoot":"","sources":["../../../src/cli/commands/marketplace.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/package-app.d.ts

@@ -0,0 +1,9 @@
+/**
+ * photon package <name> — Generate cross-platform PWA launchers
+ *
+ * Creates macOS .app, Linux .sh/.desktop, and Windows .bat launchers
+ * that auto-start a beam server and open the PWA in the default browser.
+ */
+import { Command } from 'commander';
+export declare function registerPackageAppCommand(program: Command, defaultWorkingDir: string): void;
+//# sourceMappingURL=package-app.d.ts.map

package/dist/cli/commands/package-app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-app.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/package-app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6LpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAwC3F"}

package/dist/cli/commands/package-app.js

@@ -0,0 +1,191 @@
+/**
+ * photon package <name> — Generate cross-platform PWA launchers
+ *
+ * Creates macOS .app, Linux .sh/.desktop, and Windows .bat launchers
+ * that auto-start a beam server and open the PWA in the default browser.
+ */
+import * as path from 'path';
+import * as fs from 'fs/promises';
+import { existsSync } from 'fs';
+function toClassName(name) {
+    return name
+        .split(/[-_]/)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join('');
+}
+function generateBashLauncherScript(name, photonDir, startPort, openCmd) {
+    const endPort = startPort + 9;
+    return `#!/usr/bin/env bash
+# Launcher for ${name} — auto-starts beam and opens PWA
+set -e
+
+PHOTON_DIR="${photonDir}"
+START_PORT=${startPort}
+END_PORT=${endPort}
+OPEN_CMD="${openCmd}"
+
+# Scan ports for an existing beam serving this directory
+for port in $(seq $START_PORT $END_PORT); do
+  RESP=$(curl -s --max-time 2 "http://localhost:\${port}/api/diagnostics" 2>/dev/null || true)
+  if [ -n "$RESP" ]; then
+    DIR=$(echo "$RESP" | grep -o '"workingDir":"[^"]*"' | cut -d'"' -f4)
+    if [ "$DIR" = "$PHOTON_DIR" ]; then
+      $OPEN_CMD "http://localhost:\${port}"
+      exit 0
+    fi
+  fi
+done
+
+# No existing beam found — start one
+npx @portel/photon beam --dir="$PHOTON_DIR" --port=$START_PORT &
+BEAM_PID=$!
+
+# Poll until beam is ready (up to 30s)
+WAITED=0
+while [ $WAITED -lt 30 ]; do
+  for port in $(seq $START_PORT $END_PORT); do
+    RESP=$(curl -s --max-time 1 "http://localhost:\${port}/api/diagnostics" 2>/dev/null || true)
+    if [ -n "$RESP" ]; then
+      DIR=$(echo "$RESP" | grep -o '"workingDir":"[^"]*"' | cut -d'"' -f4)
+      if [ "$DIR" = "$PHOTON_DIR" ]; then
+        $OPEN_CMD "http://localhost:\${port}"
+        exit 0
+      fi
+    fi
+  done
+  sleep 1
+  WAITED=$((WAITED + 1))
+done
+
+echo "Error: beam did not start within 30 seconds"
+exit 1
+`;
+}
+function generateInfoPlist(name, className) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>CFBundleName</key>
+  <string>${className}</string>
+  <key>CFBundleDisplayName</key>
+  <string>${className}</string>
+  <key>CFBundleIdentifier</key>
+  <string>com.photon.${name}</string>
+  <key>CFBundleExecutable</key>
+  <string>launch</string>
+  <key>CFBundleVersion</key>
+  <string>1.0</string>
+  <key>CFBundlePackageType</key>
+  <string>APPL</string>
+  <key>LSUIElement</key>
+  <true/>
+</dict>
+</plist>`;
+}
+function generateWindowsBat(name, photonDir, startPort) {
+    const endPort = startPort + 9;
+    return `@echo off
+REM Launcher for ${name} — auto-starts beam and opens PWA
+setlocal enabledelayedexpansion
+
+set "PHOTON_DIR=${photonDir}"
+set START_PORT=${startPort}
+set END_PORT=${endPort}
+
+REM Scan ports for an existing beam serving this directory
+for /L %%p in (%START_PORT%,1,%END_PORT%) do (
+  for /f "delims=" %%r in ('curl -s --max-time 2 "http://localhost:%%p/api/diagnostics" 2^>nul') do (
+    echo %%r | findstr /c:"%PHOTON_DIR%" >nul 2>&1
+    if !errorlevel! equ 0 (
+      start "" "http://localhost:%%p"
+      exit /b 0
+    )
+  )
+)
+
+REM No existing beam found — start one
+start /b npx @portel/photon beam --dir="%PHOTON_DIR%" --port=%START_PORT%
+
+REM Poll until beam is ready (up to 30s)
+set WAITED=0
+:poll
+if %WAITED% geq 30 (
+  echo Error: beam did not start within 30 seconds
+  exit /b 1
+)
+for /L %%p in (%START_PORT%,1,%END_PORT%) do (
+  for /f "delims=" %%r in ('curl -s --max-time 1 "http://localhost:%%p/api/diagnostics" 2^>nul') do (
+    echo %%r | findstr /c:"%PHOTON_DIR%" >nul 2>&1
+    if !errorlevel! equ 0 (
+      start "" "http://localhost:%%p"
+      exit /b 0
+    )
+  )
+)
+timeout /t 1 /nobreak >nul
+set /a WAITED+=1
+goto poll
+`;
+}
+async function generateMacOSApp(name, className, photonDir, startPort, outputDir) {
+    const appDir = path.join(outputDir, `${className}.app`);
+    const contentsDir = path.join(appDir, 'Contents');
+    const macosDir = path.join(contentsDir, 'MacOS');
+    await fs.mkdir(macosDir, { recursive: true });
+    await fs.writeFile(path.join(contentsDir, 'Info.plist'), generateInfoPlist(name, className));
+    const script = generateBashLauncherScript(name, photonDir, startPort, 'open');
+    await fs.writeFile(path.join(macosDir, 'launch'), script, { mode: 0o755 });
+    return appDir;
+}
+async function generateLinuxLauncher(name, photonDir, startPort, outputDir) {
+    const shPath = path.join(outputDir, `${name}.sh`);
+    const desktopPath = path.join(outputDir, `${name}.desktop`);
+    const script = generateBashLauncherScript(name, photonDir, startPort, 'xdg-open');
+    await fs.writeFile(shPath, script, { mode: 0o755 });
+    const desktop = `[Desktop Entry]
+Type=Application
+Name=${toClassName(name)}
+Exec=${shPath}
+Terminal=false
+Categories=Utility;
+`;
+    await fs.writeFile(desktopPath, desktop);
+    return [shPath, desktopPath];
+}
+async function generateWindowsLauncher(name, photonDir, startPort, outputDir) {
+    const batPath = path.join(outputDir, `${name}.bat`);
+    await fs.writeFile(batPath, generateWindowsBat(name, photonDir, startPort));
+    return batPath;
+}
+export function registerPackageAppCommand(program, defaultWorkingDir) {
+    program
+        .command('package')
+        .argument('<name>', 'Photon name to package')
+        .option('--output <dir>', 'Output directory', process.cwd())
+        .option('--port <number>', 'Preferred start port', '3000')
+        .description('Generate cross-platform PWA launchers for a photon')
+        .action(async (name, options, command) => {
+        const workingDir = command.parent?.opts().dir || defaultWorkingDir;
+        const outputDir = path.resolve(options.output);
+        const startPort = parseInt(options.port, 10);
+        // Resolve the photon directory
+        const photonDir = path.resolve(workingDir, name);
+        if (!existsSync(photonDir)) {
+            console.error(`Error: photon directory not found: ${photonDir}`);
+            process.exit(1);
+        }
+        const className = toClassName(name);
+        console.log(`\n📦 Packaging ${name}...\n`);
+        await fs.mkdir(outputDir, { recursive: true });
+        // Generate all platform launchers
+        const macAppPath = await generateMacOSApp(name, className, photonDir, startPort, outputDir);
+        const [linuxShPath, linuxDesktopPath] = await generateLinuxLauncher(name, photonDir, startPort, outputDir);
+        const winBatPath = await generateWindowsLauncher(name, photonDir, startPort, outputDir);
+        console.log(`   ✓ macOS    ${macAppPath}`);
+        console.log(`   ✓ Linux    ${linuxShPath}, ${path.basename(linuxDesktopPath)}`);
+        console.log(`   ✓ Windows  ${winBatPath}`);
+        console.log();
+    });
+}
+//# sourceMappingURL=package-app.js.map

package/dist/cli/commands/package-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-app.js","sourceRoot":"","sources":["../../../src/cli/commands/package-app.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/package.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Package CLI Commands
+ *
+ * Commands for managing photon packages: add, remove, upgrade, clear-cache
+ */
+import type { Command } from 'commander';
+/**
+ * Register package management commands
+ */
+export declare function registerPackageCommands(program: Command, defaultWorkingDir: string): void;
+//# sourceMappingURL=package.d.ts.map

package/dist/cli/commands/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/package.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4LzC;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAoezF"}