@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.
- package/LICENSE +21 -0
- package/README.md +952 -0
- package/dist/base.d.ts +58 -0
- package/dist/base.d.ts.map +1 -0
- package/dist/base.js +92 -0
- package/dist/base.js.map +1 -0
- package/dist/cli.d.ts +8 -0
- package/dist/cli.d.ts.map +1 -0
- package/dist/cli.js +1441 -0
- package/dist/cli.js.map +1 -0
- package/dist/dependency-manager.d.ts +49 -0
- package/dist/dependency-manager.d.ts.map +1 -0
- package/dist/dependency-manager.js +165 -0
- package/dist/dependency-manager.js.map +1 -0
- package/dist/loader.d.ts +86 -0
- package/dist/loader.d.ts.map +1 -0
- package/dist/loader.js +612 -0
- package/dist/loader.js.map +1 -0
- package/dist/marketplace-manager.d.ts +261 -0
- package/dist/marketplace-manager.d.ts.map +1 -0
- package/dist/marketplace-manager.js +767 -0
- package/dist/marketplace-manager.js.map +1 -0
- package/dist/path-resolver.d.ts +21 -0
- package/dist/path-resolver.d.ts.map +1 -0
- package/dist/path-resolver.js +71 -0
- package/dist/path-resolver.js.map +1 -0
- package/dist/photon-doc-extractor.d.ts +89 -0
- package/dist/photon-doc-extractor.d.ts.map +1 -0
- package/dist/photon-doc-extractor.js +228 -0
- package/dist/photon-doc-extractor.js.map +1 -0
- package/dist/readme-syncer.d.ts +33 -0
- package/dist/readme-syncer.d.ts.map +1 -0
- package/dist/readme-syncer.js +93 -0
- package/dist/readme-syncer.js.map +1 -0
- package/dist/registry-manager.d.ts +76 -0
- package/dist/registry-manager.d.ts.map +1 -0
- package/dist/registry-manager.js +220 -0
- package/dist/registry-manager.js.map +1 -0
- package/dist/schema-extractor.d.ts +83 -0
- package/dist/schema-extractor.d.ts.map +1 -0
- package/dist/schema-extractor.js +396 -0
- package/dist/schema-extractor.js.map +1 -0
- package/dist/security-scanner.d.ts +52 -0
- package/dist/security-scanner.d.ts.map +1 -0
- package/dist/security-scanner.js +172 -0
- package/dist/security-scanner.js.map +1 -0
- package/dist/server.d.ts +73 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +474 -0
- package/dist/server.js.map +1 -0
- package/dist/template-manager.d.ts +56 -0
- package/dist/template-manager.d.ts.map +1 -0
- package/dist/template-manager.js +509 -0
- package/dist/template-manager.js.map +1 -0
- package/dist/test-client.d.ts +52 -0
- package/dist/test-client.d.ts.map +1 -0
- package/dist/test-client.js +168 -0
- package/dist/test-client.js.map +1 -0
- package/dist/test-marketplace-sources.d.ts +5 -0
- package/dist/test-marketplace-sources.d.ts.map +1 -0
- package/dist/test-marketplace-sources.js +53 -0
- package/dist/test-marketplace-sources.js.map +1 -0
- package/dist/types.d.ts +108 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +12 -0
- package/dist/types.js.map +1 -0
- package/dist/version-checker.d.ts +48 -0
- package/dist/version-checker.d.ts.map +1 -0
- package/dist/version-checker.js +128 -0
- package/dist/version-checker.js.map +1 -0
- package/dist/watcher.d.ts +26 -0
- package/dist/watcher.d.ts.map +1 -0
- package/dist/watcher.js +72 -0
- package/dist/watcher.js.map +1 -0
- package/package.json +79 -0
- 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"}
|