@portel/photon 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (76) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +952 -0
  3. package/dist/base.d.ts +58 -0
  4. package/dist/base.d.ts.map +1 -0
  5. package/dist/base.js +92 -0
  6. package/dist/base.js.map +1 -0
  7. package/dist/cli.d.ts +8 -0
  8. package/dist/cli.d.ts.map +1 -0
  9. package/dist/cli.js +1441 -0
  10. package/dist/cli.js.map +1 -0
  11. package/dist/dependency-manager.d.ts +49 -0
  12. package/dist/dependency-manager.d.ts.map +1 -0
  13. package/dist/dependency-manager.js +165 -0
  14. package/dist/dependency-manager.js.map +1 -0
  15. package/dist/loader.d.ts +86 -0
  16. package/dist/loader.d.ts.map +1 -0
  17. package/dist/loader.js +612 -0
  18. package/dist/loader.js.map +1 -0
  19. package/dist/marketplace-manager.d.ts +261 -0
  20. package/dist/marketplace-manager.d.ts.map +1 -0
  21. package/dist/marketplace-manager.js +767 -0
  22. package/dist/marketplace-manager.js.map +1 -0
  23. package/dist/path-resolver.d.ts +21 -0
  24. package/dist/path-resolver.d.ts.map +1 -0
  25. package/dist/path-resolver.js +71 -0
  26. package/dist/path-resolver.js.map +1 -0
  27. package/dist/photon-doc-extractor.d.ts +89 -0
  28. package/dist/photon-doc-extractor.d.ts.map +1 -0
  29. package/dist/photon-doc-extractor.js +228 -0
  30. package/dist/photon-doc-extractor.js.map +1 -0
  31. package/dist/readme-syncer.d.ts +33 -0
  32. package/dist/readme-syncer.d.ts.map +1 -0
  33. package/dist/readme-syncer.js +93 -0
  34. package/dist/readme-syncer.js.map +1 -0
  35. package/dist/registry-manager.d.ts +76 -0
  36. package/dist/registry-manager.d.ts.map +1 -0
  37. package/dist/registry-manager.js +220 -0
  38. package/dist/registry-manager.js.map +1 -0
  39. package/dist/schema-extractor.d.ts +83 -0
  40. package/dist/schema-extractor.d.ts.map +1 -0
  41. package/dist/schema-extractor.js +396 -0
  42. package/dist/schema-extractor.js.map +1 -0
  43. package/dist/security-scanner.d.ts +52 -0
  44. package/dist/security-scanner.d.ts.map +1 -0
  45. package/dist/security-scanner.js +172 -0
  46. package/dist/security-scanner.js.map +1 -0
  47. package/dist/server.d.ts +73 -0
  48. package/dist/server.d.ts.map +1 -0
  49. package/dist/server.js +474 -0
  50. package/dist/server.js.map +1 -0
  51. package/dist/template-manager.d.ts +56 -0
  52. package/dist/template-manager.d.ts.map +1 -0
  53. package/dist/template-manager.js +509 -0
  54. package/dist/template-manager.js.map +1 -0
  55. package/dist/test-client.d.ts +52 -0
  56. package/dist/test-client.d.ts.map +1 -0
  57. package/dist/test-client.js +168 -0
  58. package/dist/test-client.js.map +1 -0
  59. package/dist/test-marketplace-sources.d.ts +5 -0
  60. package/dist/test-marketplace-sources.d.ts.map +1 -0
  61. package/dist/test-marketplace-sources.js +53 -0
  62. package/dist/test-marketplace-sources.js.map +1 -0
  63. package/dist/types.d.ts +108 -0
  64. package/dist/types.d.ts.map +1 -0
  65. package/dist/types.js +12 -0
  66. package/dist/types.js.map +1 -0
  67. package/dist/version-checker.d.ts +48 -0
  68. package/dist/version-checker.d.ts.map +1 -0
  69. package/dist/version-checker.js +128 -0
  70. package/dist/version-checker.js.map +1 -0
  71. package/dist/watcher.d.ts +26 -0
  72. package/dist/watcher.d.ts.map +1 -0
  73. package/dist/watcher.js +72 -0
  74. package/dist/watcher.js.map +1 -0
  75. package/package.json +79 -0
  76. package/templates/photon.template.ts +55 -0
@@ -0,0 +1,76 @@
1
+ /**
2
+ * Registry Manager - Manage multiple MCP registries
3
+ */
4
+ export interface Registry {
5
+ name: string;
6
+ url: string;
7
+ enabled: boolean;
8
+ }
9
+ export interface RegistryConfig {
10
+ registries: Registry[];
11
+ }
12
+ export declare class RegistryManager {
13
+ private config;
14
+ initialize(): Promise<void>;
15
+ save(): Promise<void>;
16
+ /**
17
+ * Get all registries
18
+ */
19
+ getAll(): Registry[];
20
+ /**
21
+ * Get enabled registries
22
+ */
23
+ getEnabled(): Registry[];
24
+ /**
25
+ * Get registry by name
26
+ */
27
+ get(name: string): Registry | undefined;
28
+ /**
29
+ * Parse GitHub repo reference into registry info
30
+ * Supports:
31
+ * - username/repo
32
+ * - https://github.com/username/repo
33
+ * - https://github.com/username/repo.git
34
+ */
35
+ private parseGitHubRepo;
36
+ /**
37
+ * Add a new registry from GitHub repo
38
+ * Supports: username/repo or https://github.com/username/repo
39
+ */
40
+ add(githubRepo: string): Promise<{
41
+ name: string;
42
+ url: string;
43
+ }>;
44
+ /**
45
+ * Remove a registry
46
+ */
47
+ remove(name: string): Promise<boolean>;
48
+ /**
49
+ * Enable/disable a registry
50
+ */
51
+ setEnabled(name: string, enabled: boolean): Promise<boolean>;
52
+ /**
53
+ * Try to fetch MCP from all enabled registries
54
+ */
55
+ fetchMCP(mcpName: string): Promise<{
56
+ content: string;
57
+ registry: Registry;
58
+ } | null>;
59
+ /**
60
+ * Fetch version from all enabled registries
61
+ */
62
+ fetchVersion(mcpName: string): Promise<{
63
+ version: string;
64
+ registry: Registry;
65
+ } | null>;
66
+ /**
67
+ * Search for MCP in all registries
68
+ */
69
+ search(query: string): Promise<Map<string, Registry[]>>;
70
+ /**
71
+ * List all available MCPs from a registry
72
+ * Note: Requires registry to have an index.json file
73
+ */
74
+ listFromRegistry(registryName: string): Promise<string[]>;
75
+ }
76
+ //# sourceMappingURL=registry-manager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry-manager.d.ts","sourceRoot":"","sources":["../src/registry-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,QAAQ,EAAE,CAAC;CACxB;AAWD,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAsC;IAE9C,UAAU;IAeV,IAAI;IAIV;;OAEG;IACH,MAAM,IAAI,QAAQ,EAAE;IAIpB;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIvC;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAwBvB;;;OAGG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBrE;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB5C;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAYlE;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,IAAI,CAAC;IAoBxF;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,IAAI,CAAC;IAwB5F;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAwB7D;;;OAGG;IACG,gBAAgB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAsBhE"}
@@ -0,0 +1,220 @@
1
+ /**
2
+ * Registry Manager - Manage multiple MCP registries
3
+ */
4
+ import * as fs from 'fs/promises';
5
+ import * as path from 'path';
6
+ import * as os from 'os';
7
+ import { existsSync } from 'fs';
8
+ const CONFIG_DIR = path.join(os.homedir(), '.config', 'photon');
9
+ const CONFIG_FILE = path.join(CONFIG_DIR, 'registries.json');
10
+ const DEFAULT_REGISTRY = {
11
+ name: 'photons',
12
+ url: 'https://raw.githubusercontent.com/portel-dev/photons/main',
13
+ enabled: true,
14
+ };
15
+ export class RegistryManager {
16
+ config = { registries: [] };
17
+ async initialize() {
18
+ await fs.mkdir(CONFIG_DIR, { recursive: true });
19
+ if (existsSync(CONFIG_FILE)) {
20
+ const data = await fs.readFile(CONFIG_FILE, 'utf-8');
21
+ this.config = JSON.parse(data);
22
+ }
23
+ else {
24
+ // Initialize with default registry
25
+ this.config = {
26
+ registries: [DEFAULT_REGISTRY],
27
+ };
28
+ await this.save();
29
+ }
30
+ }
31
+ async save() {
32
+ await fs.writeFile(CONFIG_FILE, JSON.stringify(this.config, null, 2), 'utf-8');
33
+ }
34
+ /**
35
+ * Get all registries
36
+ */
37
+ getAll() {
38
+ return this.config.registries;
39
+ }
40
+ /**
41
+ * Get enabled registries
42
+ */
43
+ getEnabled() {
44
+ return this.config.registries.filter((r) => r.enabled);
45
+ }
46
+ /**
47
+ * Get registry by name
48
+ */
49
+ get(name) {
50
+ return this.config.registries.find((r) => r.name === name);
51
+ }
52
+ /**
53
+ * Parse GitHub repo reference into registry info
54
+ * Supports:
55
+ * - username/repo
56
+ * - https://github.com/username/repo
57
+ * - https://github.com/username/repo.git
58
+ */
59
+ parseGitHubRepo(input) {
60
+ // Pattern 1: username/repo
61
+ const shorthandMatch = input.match(/^([a-zA-Z0-9-]+)\/([a-zA-Z0-9-_.]+)$/);
62
+ if (shorthandMatch) {
63
+ const [, username, repo] = shorthandMatch;
64
+ return {
65
+ name: repo,
66
+ url: `https://raw.githubusercontent.com/${username}/${repo}/main`,
67
+ };
68
+ }
69
+ // Pattern 2: https://github.com/username/repo or https://github.com/username/repo.git
70
+ const urlMatch = input.match(/^https?:\/\/github\.com\/([a-zA-Z0-9-]+)\/([a-zA-Z0-9-_.]+?)(\.git)?$/);
71
+ if (urlMatch) {
72
+ const [, username, repo] = urlMatch;
73
+ return {
74
+ name: repo,
75
+ url: `https://raw.githubusercontent.com/${username}/${repo}/main`,
76
+ };
77
+ }
78
+ return null;
79
+ }
80
+ /**
81
+ * Add a new registry from GitHub repo
82
+ * Supports: username/repo or https://github.com/username/repo
83
+ */
84
+ async add(githubRepo) {
85
+ const parsed = this.parseGitHubRepo(githubRepo);
86
+ if (!parsed) {
87
+ throw new Error('Invalid format. Use: username/repo or https://github.com/username/repo');
88
+ }
89
+ // Check if already exists
90
+ if (this.get(parsed.name)) {
91
+ throw new Error(`Registry '${parsed.name}' already exists`);
92
+ }
93
+ this.config.registries.push({
94
+ name: parsed.name,
95
+ url: parsed.url,
96
+ enabled: true,
97
+ });
98
+ await this.save();
99
+ return parsed;
100
+ }
101
+ /**
102
+ * Remove a registry
103
+ */
104
+ async remove(name) {
105
+ const index = this.config.registries.findIndex((r) => r.name === name);
106
+ if (index === -1) {
107
+ return false;
108
+ }
109
+ // Prevent removing the default registry
110
+ if (this.config.registries[index].url === DEFAULT_REGISTRY.url) {
111
+ throw new Error('Cannot remove the default photons registry');
112
+ }
113
+ this.config.registries.splice(index, 1);
114
+ await this.save();
115
+ return true;
116
+ }
117
+ /**
118
+ * Enable/disable a registry
119
+ */
120
+ async setEnabled(name, enabled) {
121
+ const registry = this.get(name);
122
+ if (!registry) {
123
+ return false;
124
+ }
125
+ registry.enabled = enabled;
126
+ await this.save();
127
+ return true;
128
+ }
129
+ /**
130
+ * Try to fetch MCP from all enabled registries
131
+ */
132
+ async fetchMCP(mcpName) {
133
+ const enabled = this.getEnabled();
134
+ for (const registry of enabled) {
135
+ try {
136
+ const url = `${registry.url}/${mcpName}.photon.ts`;
137
+ const response = await fetch(url);
138
+ if (response.ok) {
139
+ const content = await response.text();
140
+ return { content, registry };
141
+ }
142
+ }
143
+ catch {
144
+ // Try next registry
145
+ }
146
+ }
147
+ return null;
148
+ }
149
+ /**
150
+ * Fetch version from all enabled registries
151
+ */
152
+ async fetchVersion(mcpName) {
153
+ const enabled = this.getEnabled();
154
+ for (const registry of enabled) {
155
+ try {
156
+ const url = `${registry.url}/${mcpName}.photon.ts`;
157
+ const response = await fetch(url);
158
+ if (response.ok) {
159
+ const content = await response.text();
160
+ const versionMatch = content.match(/@version\s+(\d+\.\d+\.\d+)/);
161
+ if (versionMatch) {
162
+ return { version: versionMatch[1], registry };
163
+ }
164
+ }
165
+ }
166
+ catch {
167
+ // Try next registry
168
+ }
169
+ }
170
+ return null;
171
+ }
172
+ /**
173
+ * Search for MCP in all registries
174
+ */
175
+ async search(query) {
176
+ const results = new Map();
177
+ const enabled = this.getEnabled();
178
+ // For now, we just check if the MCP exists by name
179
+ // In the future, registries could provide a manifest/index file
180
+ for (const registry of enabled) {
181
+ try {
182
+ const url = `${registry.url}/${query}.photon.ts`;
183
+ const response = await fetch(url, { method: 'HEAD' });
184
+ if (response.ok) {
185
+ const existing = results.get(query) || [];
186
+ existing.push(registry);
187
+ results.set(query, existing);
188
+ }
189
+ }
190
+ catch {
191
+ // Skip this registry
192
+ }
193
+ }
194
+ return results;
195
+ }
196
+ /**
197
+ * List all available MCPs from a registry
198
+ * Note: Requires registry to have an index.json file
199
+ */
200
+ async listFromRegistry(registryName) {
201
+ const registry = this.get(registryName);
202
+ if (!registry) {
203
+ return [];
204
+ }
205
+ try {
206
+ // Try to fetch index.json if it exists
207
+ const indexUrl = `${registry.url}/index.json`;
208
+ const response = await fetch(indexUrl);
209
+ if (response.ok) {
210
+ const data = await response.json();
211
+ return data.mcps || [];
212
+ }
213
+ }
214
+ catch {
215
+ // No index file available
216
+ }
217
+ return [];
218
+ }
219
+ }
220
+ //# sourceMappingURL=registry-manager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"registry-manager.js","sourceRoot":"","sources":["../src/registry-manager.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * Schema Extractor
3
+ *
4
+ * Extracts JSON schemas from TypeScript method signatures and JSDoc comments
5
+ * Also extracts constructor parameters for config injection
6
+ * Supports Templates (@Template) and Static resources (@Static)
7
+ *
8
+ * Now uses TypeScript's compiler API for robust type parsing
9
+ */
10
+ import { ExtractedSchema, ConstructorParam, TemplateInfo, StaticInfo } from './types.js';
11
+ export interface ExtractedMetadata {
12
+ tools: ExtractedSchema[];
13
+ templates: TemplateInfo[];
14
+ statics: StaticInfo[];
15
+ }
16
+ /**
17
+ * Extract schemas from a Photon MCP class file
18
+ */
19
+ export declare class SchemaExtractor {
20
+ /**
21
+ * Extract method schemas from source code file
22
+ */
23
+ extractFromFile(filePath: string): Promise<ExtractedSchema[]>;
24
+ /**
25
+ * Extract all metadata (tools, templates, statics) from source code
26
+ */
27
+ extractAllFromSource(source: string): ExtractedMetadata;
28
+ /**
29
+ * Extract schemas from source code string (backward compatibility)
30
+ */
31
+ extractFromSource(source: string): ExtractedSchema[];
32
+ /**
33
+ * Get JSDoc comment for a node
34
+ */
35
+ private getJSDocComment;
36
+ /**
37
+ * Get the first parameter's type node
38
+ */
39
+ private getFirstParameterType;
40
+ /**
41
+ * Build JSON schema from TypeScript type node
42
+ */
43
+ private buildSchemaFromType;
44
+ /**
45
+ * Convert TypeScript type node to JSON schema
46
+ */
47
+ private typeNodeToSchema;
48
+ /**
49
+ * Extract constructor parameters for config injection
50
+ */
51
+ extractConstructorParams(source: string): ConstructorParam[];
52
+ /**
53
+ * Extract default value from initializer
54
+ */
55
+ private extractDefaultValue;
56
+ /**
57
+ * Extract main description from JSDoc comment
58
+ */
59
+ private extractDescription;
60
+ /**
61
+ * Extract parameter descriptions from JSDoc @param tags
62
+ */
63
+ private extractParamDocs;
64
+ /**
65
+ * Check if JSDoc contains @Template tag
66
+ */
67
+ private hasTemplateTag;
68
+ /**
69
+ * Check if JSDoc contains @Static tag
70
+ */
71
+ private hasStaticTag;
72
+ /**
73
+ * Extract URI pattern from @Static tag
74
+ * Example: @Static github://repos/{owner}/{repo}/readme
75
+ */
76
+ private extractStaticURI;
77
+ /**
78
+ * Extract MIME type from @mimeType tag
79
+ * Example: @mimeType text/markdown
80
+ */
81
+ private extractMimeType;
82
+ }
83
+ //# sourceMappingURL=schema-extractor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema-extractor.d.ts","sourceRoot":"","sources":["../src/schema-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAUnE;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB;IA0GvD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,EAAE;IAIpD;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkGxB;;OAEG;IACH,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAmD5D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;;OAGG;IACH,OAAO,CAAC,eAAe;CAIxB"}