@portel/photon 1.0.0

package/dist/template-manager.js

@@ -0,0 +1,509 @@
+import { existsSync } from 'fs';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as crypto from 'crypto';
+/**
+ * Manages marketplace documentation templates
+ *
+ * Templates are stored in .marketplace/_templates/ and can be customized by users.
+ * Hash-based detection prevents overwriting user customizations.
+ */
+export class TemplateManager {
+    workingDir;
+    marketplaceDir;
+    templateDir;
+    hashFile;
+    // Current template version - increment when templates are updated
+    static TEMPLATE_VERSION = '1.0.0';
+    constructor(workingDir) {
+        this.workingDir = workingDir;
+        this.marketplaceDir = path.join(workingDir, '.marketplace');
+        this.templateDir = path.join(this.marketplaceDir, '_templates');
+        this.hashFile = path.join(this.marketplaceDir, '.template-hashes.json');
+    }
+    /**
+     * Ensure templates directory exists and templates are initialized
+     */
+    async ensureTemplates() {
+        // Create directories
+        await fs.mkdir(this.templateDir, { recursive: true });
+        // Load or initialize hash tracking
+        const hashes = await this.loadHashes();
+        // Check and update each template
+        await this.ensureTemplate('readme.md', this.getDefaultReadmeTemplate(), hashes);
+        await this.ensureTemplate('photon.md', this.getDefaultPhotonTemplate(), hashes);
+        // Save updated hashes
+        await this.saveHashes(hashes);
+    }
+    /**
+     * Check if a template has been customized by the user
+     */
+    async isTemplateCustomized(templateName) {
+        const hashes = await this.loadHashes();
+        return hashes[templateName]?.customized || false;
+    }
+    /**
+     * Render a template with provided data
+     */
+    async renderTemplate(templateName, data) {
+        const templatePath = path.join(this.templateDir, templateName);
+        if (!existsSync(templatePath)) {
+            throw new Error(`Template not found: ${templateName}`);
+        }
+        const template = await fs.readFile(templatePath, 'utf-8');
+        return this.render(template, data);
+    }
+    /**
+     * Simple template renderer using template literals
+     * Safely evaluates ${expression} in templates
+     */
+    render(template, data) {
+        // Helper functions available in templates
+        // Using $ prefix to avoid reserved keywords
+        const helpers = {
+            // Loop over array
+            each: (items, fn) => {
+                return items.map((item, index) => fn(item, index)).join('');
+            },
+            // Conditional rendering
+            $if: (condition, truthy, falsy = '') => {
+                return condition ? truthy : falsy;
+            },
+            // Default value
+            $default: (value, defaultValue) => {
+                return value !== undefined && value !== null && value !== '' ? value : defaultValue;
+            },
+            // Extract proper name from description (before " - ")
+            properName: (desc, fallbackName) => {
+                if (desc.includes(' - ')) {
+                    return desc.split(' - ')[0];
+                }
+                // Fallback: title case the name
+                return fallbackName.split('-').map(word => word.charAt(0).toUpperCase() + word.slice(1)).join(' ');
+            },
+            // Extract description after " - " separator
+            cleanDesc: (desc) => {
+                return desc.includes(' - ') ? desc.split(' - ').slice(1).join(' - ') : desc;
+            },
+        };
+        try {
+            // Create function with data and helpers in scope
+            const fn = new Function('data', 'helpers', `
+        with (data) {
+          const { each, $if, $default, properName, cleanDesc } = helpers;
+          return \`${template}\`;
+        }
+        `);
+            return fn(data, helpers);
+        }
+        catch (error) {
+            throw new Error(`Template rendering error: ${error.message}`);
+        }
+    }
+    /**
+     * Ensure a single template exists and is up-to-date
+     */
+    async ensureTemplate(name, defaultContent, hashes) {
+        const templatePath = path.join(this.templateDir, name);
+        const defaultHash = this.calculateHash(defaultContent);
+        if (!existsSync(templatePath)) {
+            // Template doesn't exist - create it
+            await fs.writeFile(templatePath, defaultContent, 'utf-8');
+            hashes[name] = {
+                version: TemplateManager.TEMPLATE_VERSION,
+                hash: defaultHash,
+                customized: false,
+            };
+            console.error(`   ✓ Created template: _templates/${name}`);
+        }
+        else {
+            // Template exists - check if customized
+            const currentContent = await fs.readFile(templatePath, 'utf-8');
+            const currentHash = this.calculateHash(currentContent);
+            const tracked = hashes[name];
+            if (!tracked) {
+                // Not tracked yet - assume customized
+                hashes[name] = {
+                    version: TemplateManager.TEMPLATE_VERSION,
+                    hash: currentHash,
+                    customized: true,
+                };
+            }
+            else if (currentHash === tracked.hash) {
+                // Unchanged from last sync
+                if (!tracked.customized && defaultHash !== tracked.hash) {
+                    // Template was default but we have a new version - update it
+                    await fs.writeFile(templatePath, defaultContent, 'utf-8');
+                    hashes[name] = {
+                        version: TemplateManager.TEMPLATE_VERSION,
+                        hash: defaultHash,
+                        customized: false,
+                    };
+                    console.error(`   ✓ Updated template: _templates/${name} (new version)`);
+                }
+            }
+            else {
+                // Hash changed - user customized it
+                hashes[name] = {
+                    ...tracked,
+                    hash: currentHash,
+                    customized: true,
+                };
+            }
+        }
+    }
+    /**
+     * Load template hashes from file
+     */
+    async loadHashes() {
+        if (!existsSync(this.hashFile)) {
+            return {};
+        }
+        try {
+            const content = await fs.readFile(this.hashFile, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Save template hashes to file
+     */
+    async saveHashes(hashes) {
+        await fs.writeFile(this.hashFile, JSON.stringify(hashes, null, 2), 'utf-8');
+    }
+    /**
+     * Calculate SHA-256 hash of content
+     */
+    calculateHash(content) {
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
+    /**
+     * Get default README template
+     */
+    getDefaultReadmeTemplate() {
+        return `# \${marketplaceName}
+
+> **Singular focus. Precise target.**
+
+\${$if(marketplaceDescription, \`\${marketplaceDescription}\n\n\`, \`Photons are single-file TypeScript classes that run as [MCP servers](https://modelcontextprotocol.io/introduction). Add them to your favorite AI assistant using the [Photon runtime](https://github.com/portel-dev/photon).\n\n\`)}\${$if(marketplaceName === 'photons', \`## 🏛️ Official Marketplace
+
+This is the **official Photon marketplace** maintained by Portel. It comes pre-configured with Photon - no manual setup needed.
+
+**Already available to you:**
+- ✅ Pre-installed with Photon
+- ✅ Automatically updated
+- ✅ Production-ready photons
+- ✅ Community-maintained
+
+**Want to contribute?**
+We welcome contributions! Submit pull requests for:
+- 🐛 Bug fixes to existing photons
+- ✨ Enhancements and new features
+- 📦 New photons to add to the marketplace
+- 📝 Documentation improvements
+
+**Repository:** [github.com/portel-dev/photons](https://github.com/portel-dev/photons)
+
+\`, '')}## 📦 Available Photons
+
+| Photon | Focus | Tools | Details |
+|--------|-------|-------|---------|
+\${each(photons, (p) => \`| **\${properName(p.description, p.name)}** | \${cleanDesc(p.description)} | \${p.tools ? p.tools.length : 0} | [View →](\${p.name}.md) |\n\`)}
+
+**Total:** \${photons.length} photons ready to use
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install Photon
+
+\\\`\\\`\\\`bash
+npm install -g @portel/photon
+\\\`\\\`\\\`
+
+### 2. Add Any Photon
+
+\\\`\\\`\\\`bash
+photon add filesystem
+photon add git
+photon add aws-s3
+\\\`\\\`\\\`
+
+### 3. Use It
+
+\\\`\\\`\\\`bash
+# Run as MCP server
+photon mcp filesystem
+
+# Get config for your MCP client
+photon get filesystem --mcp
+\\\`\\\`\\\`
+
+Output (paste directly into your MCP client config):
+\\\`\\\`\\\`json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "photon",
+      "args": ["mcp", "filesystem"]
+    }
+  }
+}
+\\\`\\\`\\\`
+
+Add the output to your MCP client's configuration. **Consult your client's documentation** for setup instructions.
+
+**That's it!** Your AI assistant now has \${photons.length} focused tools at its fingertips.
+
+## ⚛️ What Are Photons?
+
+**Photons** are laser-focused modules - each does ONE thing exceptionally well:
+- 📁 **Filesystem** - File operations
+- 🐙 **Git** - Repository management
+- ☁️ **AWS S3** - Cloud storage
+- 📅 **Google Calendar** - Calendar integration
+- 🕐 **Time** - Timezone operations
+- ... and more
+
+Each photon delivers **singular focus** to a **precise target**.
+
+**Key Features:**
+- 🎯 Each photon does one thing perfectly
+- 📦 \${photons.length} production-ready photons available
+- ⚡ Auto-installs dependencies
+- 🔧 Works out of the box
+- 📄 Single-file design (easy to fork and customize)
+
+## 🎯 The Value Proposition
+
+### Before Photon
+
+For each MCP server:
+1. Find and clone the repository
+2. Install dependencies manually
+3. Configure environment variables
+4. Write MCP client config JSON by hand
+5. Repeat for every server
+
+### With Photon
+
+\\\`\\\`\\\`bash
+# Install from marketplace
+photon add filesystem
+
+# Get MCP config
+photon get filesystem --mcp
+\\\`\\\`\\\`
+
+Output (paste directly into your MCP client config):
+\\\`\\\`\\\`json
+{
+  "mcpServers": {
+    "filesystem": {
+      "command": "photon",
+      "args": ["mcp", "filesystem"]
+    }
+  }
+}
+\\\`\\\`\\\`
+
+**That's it.** No dependencies, no environment setup, no configuration files.
+
+**Difference:**
+- ✅ One CLI, one command
+- ✅ Zero configuration
+- ✅ Instant installation
+- ✅ Auto-dependencies
+- ✅ Consistent experience
+
+## 💡 Use Cases
+
+**For Claude Users:**
+\\\`\\\`\\\`bash
+photon add filesystem git github-issues
+photon get --mcp  # Get config for all three
+\\\`\\\`\\\`
+Add to Claude Desktop → Now Claude can read files, manage repos, create issues
+
+**For Teams:**
+\\\`\\\`\\\`bash
+photon add postgres mongodb redis
+photon get --mcp
+\\\`\\\`\\\`
+Give Claude access to your data infrastructure
+
+**For Developers:**
+\\\`\\\`\\\`bash
+photon add docker git slack
+photon get --mcp
+\\\`\\\`\\\`
+Automate your workflow through AI
+
+## 🔍 Browse & Search
+
+\\\`\\\`\\\`bash
+# List all photons
+photon get
+
+# Search by keyword
+photon search calendar
+
+# View details
+photon get google-calendar
+
+# Upgrade all
+photon upgrade
+\\\`\\\`\\\`
+
+## 🏢 For Enterprises
+
+Create your own marketplace:
+
+\\\`\\\`\\\`bash
+# 1. Organize photons
+mkdir company-photons && cd company-photons
+
+# 2. Generate marketplace
+photon sync marketplace
+
+# 3. Share with team
+git push origin main
+
+# Team members use:
+photon marketplace add company/photons
+photon add your-internal-tool
+\\\`\\\`\\\`
+
+---
+
+**Built with singular focus. Deployed with precise targeting.**
+
+Made with ⚛️ by [Portel](https://github.com/portel-dev)
+`;
+    }
+    /**
+     * Get default Photon documentation template
+     */
+    getDefaultPhotonTemplate() {
+        return `# \${properName(description, name)}
+
+\${cleanDesc(description)}
+
+## 📋 Overview
+
+**Version:** \${version}
+**Author:** \${author || 'Unknown'}
+**License:** \${license || 'MIT'}\${$if(repository, \`  \n**Repository:** \${repository}\`, '')}\${$if(homepage, \`  \n**Homepage:** \${homepage}\`, '')}
+
+## ⚙️ Configuration
+
+### Environment Variables
+
+\${each(configParams || [], (param) => \`
+- **\\\`\${param.envVar}\\\`** \${param.required ? '[REQUIRED]' : '[OPTIONAL]'}
+  - Type: \${param.type}
+  - Description: \${param.description}
+  \${param.default ? \`- Default: \\\`\${param.default}\\\`\` : ''}
+\`)}
+
+\${$if(!configParams || configParams.length === 0, \`
+No configuration required.
+\`)}
+
+\${$if(setupInstructions, \`
+### Setup Instructions
+
+\${setupInstructions}
+\`)}
+
+## 🔧 Tools
+
+This photon provides **\${tools ? tools.length : 0}** tools:
+
+\${each(tools || [], (tool) => \`
+### \\\`\${tool.name}\\\`
+
+\${tool.description || 'No description available'}
+
+\${$if(tool.params && tool.params.length > 0, \`
+**Parameters:**
+
+\${each(tool.params, (p) => \`
+- **\\\`\${p.name}\\\`** (\${p.type}\${p.optional ? ', optional' : ''}) - \${p.description || 'No description'}
+\`)}
+\`)}
+
+\${$if(tool.example, \`
+**Example:**
+
+\\\`\\\`\\\`typescript
+\${tool.example}
+\\\`\\\`\\\`
+\`)}
+
+---
+
+\`)}
+
+\${$if(!tools || tools.length === 0, \`
+No tools defined.
+\`)}
+
+## 📥 Usage
+
+### Install Photon CLI
+
+\\\`\\\`\\\`bash
+npm install -g @portel/photon
+\\\`\\\`\\\`
+
+### Run This Photon
+
+**Option 1: Run directly from file**
+
+\\\`\\\`\\\`bash
+# Clone/download the photon file
+photon mcp ./\${name}.photon.ts
+\\\`\\\`\\\`
+
+**Option 2: Install to ~/.photon/ (recommended)**
+
+\\\`\\\`\\\`bash
+# Copy to photon directory
+cp \${name}.photon.ts ~/.photon/
+
+# Run by name
+photon mcp \${name}
+\\\`\\\`\\\`
+
+**Option 3: Use with Claude Desktop**
+
+\\\`\\\`\\\`bash
+# Generate MCP configuration
+photon mcp \${name} --config
+
+# Add the output to ~/Library/Application Support/Claude/claude_desktop_config.json
+\\\`\\\`\\\`
+
+## 📦 Dependencies
+
+\${$if(dependencies, \`
+This photon automatically installs the following dependencies:
+
+\\\`\\\`\\\`
+\${dependencies}
+\\\`\\\`\\\`
+\`, \`
+No external dependencies required.
+\`)}
+
+## 📄 License
+
+\${license || 'MIT'} • Version \${version}
+`;
+    }
+}
+//# sourceMappingURL=template-manager.js.map

package/dist/template-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-manager.js","sourceRoot":"","sources":["../src/template-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAYjC;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAQN;IAPZ,cAAc,CAAS;IACvB,WAAW,CAAS;IACpB,QAAQ,CAAS;IAEzB,kEAAkE;IAC1D,MAAM,CAAU,gBAAgB,GAAG,OAAO,CAAC;IAEnD,YAAoB,UAAkB;QAAlB,eAAU,GAAV,UAAU,CAAQ;QACpC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,uBAAuB,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe;QACnB,qBAAqB;QACrB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtD,mCAAmC;QACnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAEvC,iCAAiC;QACjC,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,wBAAwB,EAAE,EAAE,MAAM,CAAC,CAAC;QAChF,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,wBAAwB,EAAE,EAAE,MAAM,CAAC,CAAC;QAEhF,sBAAsB;QACtB,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,YAAoB;QAC7C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACvC,OAAO,MAAM,CAAC,YAAY,CAAC,EAAE,UAAU,IAAI,KAAK,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,YAAoB,EAAE,IAAS;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QAE/D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,QAAgB,EAAE,IAAS;QACxC,0CAA0C;QAC1C,4CAA4C;QAC5C,MAAM,OAAO,GAAG;YACd,kBAAkB;YAClB,IAAI,EAAE,CAAI,KAAU,EAAE,EAAsC,EAAU,EAAE;gBACtE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC9D,CAAC;YAED,wBAAwB;YACxB,GAAG,EAAE,CAAC,SAAkB,EAAE,MAAc,EAAE,KAAK,GAAG,EAAE,EAAU,EAAE;gBAC9D,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;YACpC,CAAC;YAED,gBAAgB;YAChB,QAAQ,EAAE,CAAC,KAAU,EAAE,YAAiB,EAAO,EAAE;gBAC/C,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC;YACtF,CAAC;YAED,sDAAsD;YACtD,UAAU,EAAE,CAAC,IAAY,EAAE,YAAoB,EAAU,EAAE;gBACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9B,CAAC;gBACD,gCAAgC;gBAChC,OAAO,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrG,CAAC;YAED,4CAA4C;YAC5C,SAAS,EAAE,CAAC,IAAY,EAAU,EAAE;gBAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9E,CAAC;SACF,CAAC;QAEF,IAAI,CAAC;YACH,iDAAiD;YACjD,MAAM,EAAE,GAAG,IAAI,QAAQ,CACrB,MAAM,EACN,SAAS,EACT;;;qBAGa,QAAQ;;SAEpB,CACF,CAAC;YAEF,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,cAAc,CAC1B,IAAY,EACZ,cAAsB,EACtB,MAAsB;QAEtB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACvD,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAEvD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,qCAAqC;YACrC,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,GAAG;gBACb,OAAO,EAAE,eAAe,CAAC,gBAAgB;gBACzC,IAAI,EAAE,WAAW;gBACjB,UAAU,EAAE,KAAK;aAClB,CAAC;YACF,OAAO,CAAC,KAAK,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,wCAAwC;YACxC,MAAM,cAAc,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAChE,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;YACvD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,sCAAsC;gBACtC,MAAM,CAAC,IAAI,CAAC,GAAG;oBACb,OAAO,EAAE,eAAe,CAAC,gBAAgB;oBACzC,IAAI,EAAE,WAAW;oBACjB,UAAU,EAAE,IAAI;iBACjB,CAAC;YACJ,CAAC;iBAAM,IAAI,WAAW,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;gBACxC,2BAA2B;gBAC3B,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,WAAW,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;oBACxD,6DAA6D;oBAC7D,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;oBAC1D,MAAM,CAAC,IAAI,CAAC,GAAG;wBACb,OAAO,EAAE,eAAe,CAAC,gBAAgB;wBACzC,IAAI,EAAE,WAAW;wBACjB,UAAU,EAAE,KAAK;qBAClB,CAAC;oBACF,OAAO,CAAC,KAAK,CAAC,qCAAqC,IAAI,gBAAgB,CAAC,CAAC;gBAC3E,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,oCAAoC;gBACpC,MAAM,CAAC,IAAI,CAAC,GAAG;oBACb,GAAG,OAAO;oBACV,IAAI,EAAE,WAAW;oBACjB,UAAU,EAAE,IAAI;iBACjB,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU;QACtB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,UAAU,CAAC,MAAsB;QAC7C,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAC/B,OAAO,CACR,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,OAAe;QACnC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACK,wBAAwB;QAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuMV,CAAC;IACA,CAAC;IAED;;OAEG;IACK,wBAAwB;QAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmHV,CAAC;IACA,CAAC"}

package/dist/test-client.d.ts

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * MCP Test Client - Automated testing for Photon MCPs
+ *
+ * Spawns MCP servers, sends protocol messages, validates responses
+ */
+interface MCPResponse {
+    jsonrpc: '2.0';
+    id: number | string;
+    result?: any;
+    error?: {
+        code: number;
+        message: string;
+        data?: any;
+    };
+}
+interface TestCase {
+    name: string;
+    method: string;
+    params?: any;
+    validate: (response: MCPResponse) => boolean | string;
+}
+export declare class MCPTestClient {
+    private process?;
+    private requestId;
+    private pendingRequests;
+    start(command: string, args: string[], env?: Record<string, string>): Promise<void>;
+    send(method: string, params?: any): Promise<MCPResponse>;
+    initialize(serverInfo?: {
+        name: string;
+        version: string;
+    }): Promise<MCPResponse>;
+    listTools(): Promise<MCPResponse>;
+    callTool(name: string, args?: any): Promise<MCPResponse>;
+    runTests(tests: TestCase[]): Promise<{
+        passed: number;
+        failed: number;
+        errors: string[];
+    }>;
+    shutdown(): Promise<void>;
+}
+export declare const validators: {
+    hasResult: (response: MCPResponse) => true | "Response missing result field";
+    hasError: (response: MCPResponse) => true | "Response missing error field";
+    matchesPattern: (pattern: RegExp, field?: string) => (response: MCPResponse) => string | true;
+    hasField: (field: string) => (response: MCPResponse) => string | true;
+    equals: (expected: any, field?: string) => (response: MCPResponse) => string | true;
+    custom: (fn: (result: any) => boolean | string) => (response: MCPResponse) => string | boolean;
+    and: (...validators: Array<(response: MCPResponse) => boolean | string>) => (response: MCPResponse) => string | boolean;
+};
+export {};
+//# sourceMappingURL=test-client.d.ts.map

package/dist/test-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-client.d.ts","sourceRoot":"","sources":["../src/test-client.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAYH,UAAU,WAAW;IACnB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,GAAG,CAAC;KACZ,CAAC;CACH;AAED,UAAU,QAAQ;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,GAAG,CAAC;IACb,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,KAAK,OAAO,GAAG,MAAM,CAAC;CACvD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAGlB;IAEC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDnF,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BxD,UAAU,CAAC,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAQhF,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC;IAIjC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC;IAIxD,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA8B1F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAOhC;AAGD,eAAO,MAAM,UAAU;0BACC,WAAW;yBAGZ,WAAW;8BAGN,MAAM,UAAU,MAAM,MAAM,UAAU,WAAW;sBAOzD,MAAM,MAAM,UAAU,WAAW;uBAYhC,GAAG,UAAU,MAAM,MAAM,UAAU,WAAW;iBAMpD,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,GAAG,MAAM,MAAM,UAAU,WAAW;yBAIpD,KAAK,CAAC,CAAC,QAAQ,EAAE,WAAW,KAAK,OAAO,GAAG,MAAM,CAAC,MAAM,UAAU,WAAW;CAOnG,CAAC"}