@portel/photon 1.0.0

package/dist/watcher.js

@@ -0,0 +1,72 @@
+/**
+ * File Watcher for Dev Mode
+ *
+ * Watches .photon.ts file for changes and triggers hot reload
+ */
+import chokidar from 'chokidar';
+import * as path from 'path';
+export class FileWatcher {
+    watcher = null;
+    server;
+    filePath;
+    reloadTimeout = null;
+    constructor(server, filePath) {
+        this.server = server;
+        this.filePath = path.resolve(filePath);
+    }
+    /**
+     * Start watching the file
+     */
+    start() {
+        console.error(`Watching ${path.basename(this.filePath)} for changes...`);
+        this.watcher = chokidar.watch(this.filePath, {
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 100,
+                pollInterval: 50,
+            },
+        });
+        this.watcher.on('change', (changedPath) => {
+            this.handleFileChange(changedPath);
+        });
+        this.watcher.on('error', (error) => {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`Watcher error: ${message}`);
+        });
+    }
+    /**
+     * Handle file change event
+     */
+    handleFileChange(changedPath) {
+        console.error(`♻️  File changed: ${path.basename(changedPath)}`);
+        // Debounce rapid changes
+        if (this.reloadTimeout) {
+            clearTimeout(this.reloadTimeout);
+        }
+        this.reloadTimeout = setTimeout(async () => {
+            try {
+                await this.server.reload();
+                console.error('✅ Hot reload complete');
+            }
+            catch (error) {
+                console.error(`❌ Hot reload failed: ${error.message}`);
+            }
+        }, 200);
+    }
+    /**
+     * Stop watching
+     */
+    async stop() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+        if (this.reloadTimeout) {
+            clearTimeout(this.reloadTimeout);
+            this.reloadTimeout = null;
+        }
+        console.error('File watcher stopped');
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAA4B,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,MAAM,OAAO,WAAW;IACd,OAAO,GAAqB,IAAI,CAAC;IACjC,MAAM,CAAe;IACrB,QAAQ,CAAS;IACjB,aAAa,GAA0B,IAAI,CAAC;IAEpD,YAAY,MAAoB,EAAE,QAAgB;QAChD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAEzE,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC3C,UAAU,EAAE,IAAI;YAChB,aAAa,EAAE,IAAI;YACnB,gBAAgB,EAAE;gBAChB,kBAAkB,EAAE,GAAG;gBACvB,YAAY,EAAE,EAAE;aACjB;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,WAAmB,EAAE,EAAE;YAChD,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAc,EAAE,EAAE;YAC1C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,CAAC,KAAK,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,WAAmB;QAC1C,OAAO,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAEjE,yBAAyB;QACzB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YACzC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC3B,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,KAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,wBAAwB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACjC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACxC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@portel/photon",
+  "version": "1.0.0",
+  "description": "You focus on the business logic. We'll enable the rest. Build MCP servers in a single TypeScript file.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "photon": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "npm run test:all",
+    "test:all": "npm run build && npm run test:schema && npm run test:marketplace && npm run test:loader && npm run test:server && npm run test:integration && npm run test:readme",
+    "test:readme": "bash tests/readme-validation.sh",
+    "test:schema": "npx tsx tests/schema-extractor.test.ts",
+    "test:marketplace": "npx tsx tests/marketplace-manager.test.ts",
+    "test:loader": "npx tsx tests/loader.test.ts",
+    "test:server": "npx tsx tests/server.test.ts",
+    "test:integration": "npx tsx tests/integration.test.ts",
+    "test:load": "npm run build && node --expose-gc --max-old-space-size=4096 node_modules/.bin/tsx tests/load-test.ts",
+    "test:sqlite": "npm run build && npx tsx tests/sqlite.test.ts",
+    "test:github": "npm run build && npx tsx tests/github-issues.test.ts",
+    "release": "release-it",
+    "release:minor": "release-it minor",
+    "release:major": "release-it major",
+    "release:patch": "release-it patch",
+    "release:dry": "release-it --dry-run"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "photon",
+    "typescript",
+    "cli",
+    "single-file",
+    "business-logic",
+    "convention-over-configuration",
+    "claude",
+    "claude-desktop",
+    "hot-reload",
+    "marketplace",
+    "enterprise"
+  ],
+  "author": "Portel Dev",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "chokidar": "^4.0.3",
+    "commander": "^12.1.0",
+    "esbuild": "^0.24.2",
+    "typescript": "^5.0.0"
+  },
+  "devDependencies": {
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/node": "^22.10.2",
+    "autocannon": "^8.0.0",
+    "clinic": "^13.0.0",
+    "release-it": "^19.0.6",
+    "tsx": "^4.20.6",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/portel-dev/photon.git"
+  },
+  "bugs": {
+    "url": "https://github.com/portel-dev/photon/issues"
+  },
+  "homepage": "https://github.com/portel-dev/photon#readme"
+}

package/templates/photon.template.ts

@@ -0,0 +1,55 @@
+/**
+ * TemplateName Photon MCP
+ *
+ * Single-file MCP server using Photon
+ * Run with: npx photon template-name.photon.ts --dev
+ */
+
+export default class TemplateName {
+  /**
+   * Optional initialization hook
+   * Called once when the MCP is loaded
+   */
+  async onInitialize?() {
+    console.error('[template-name] Initialized');
+  }
+
+  /**
+   * Optional shutdown hook
+   * Called when the MCP is shutting down
+   */
+  async onShutdown?() {
+    console.error('[template-name] Shutting down');
+  }
+
+  /**
+   * Example echo tool
+   * @param message Message to echo back
+   */
+  async echo(params: { message: string }) {
+    return `Echo: ${params.message}`;
+  }
+
+  /**
+   * Add two numbers together
+   * @param a First number
+   * @param b Second number
+   */
+  async add(params: { a: number; b: number }) {
+    return {
+      success: true,
+      content: `${params.a} + ${params.b} = ${params.a + params.b}`,
+    };
+  }
+
+  /**
+   * Get current timestamp
+   */
+  async getCurrentTime(params: {}) {
+    const now = new Date();
+    return {
+      success: true,
+      content: `Current time: ${now.toISOString()}`,
+    };
+  }
+}