xypriss 4.0.1 → 4.1.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 (54) hide show
  1. package/dist/cjs/src/config.js +57 -31
  2. package/dist/cjs/src/config.js.map +1 -1
  3. package/dist/cjs/src/file-upload.js +5 -4
  4. package/dist/cjs/src/file-upload.js.map +1 -1
  5. package/dist/cjs/src/index.js +1 -1
  6. package/dist/cjs/src/plugins/api/PluginAPI.js +135 -0
  7. package/dist/cjs/src/plugins/api/PluginAPI.js.map +1 -0
  8. package/dist/cjs/src/plugins/core/PluginManager.js +46 -0
  9. package/dist/cjs/src/plugins/core/PluginManager.js.map +1 -1
  10. package/dist/cjs/src/server/FastServer.js +28 -15
  11. package/dist/cjs/src/server/FastServer.js.map +1 -1
  12. package/dist/cjs/src/server/ServerFactory.js +27 -22
  13. package/dist/cjs/src/server/ServerFactory.js.map +1 -1
  14. package/dist/cjs/src/server/components/fastapi/FileUploadManager.js +3 -2
  15. package/dist/cjs/src/server/components/fastapi/FileUploadManager.js.map +1 -1
  16. package/dist/cjs/src/server/components/fastapi/console/ConsoleInterceptor.js +74 -22
  17. package/dist/cjs/src/server/components/fastapi/console/ConsoleInterceptor.js.map +1 -1
  18. package/dist/cjs/src/server/components/fastapi/console/types.js +0 -1
  19. package/dist/cjs/src/server/components/fastapi/console/types.js.map +1 -1
  20. package/dist/cjs/src/server/const/default.js +75 -0
  21. package/dist/cjs/src/server/const/default.js.map +1 -1
  22. package/dist/cjs/src/server/handlers/NotFoundHandler.js +1 -1
  23. package/dist/esm/src/config.js +57 -31
  24. package/dist/esm/src/config.js.map +1 -1
  25. package/dist/esm/src/file-upload.js +3 -2
  26. package/dist/esm/src/file-upload.js.map +1 -1
  27. package/dist/esm/src/index.js +1 -1
  28. package/dist/esm/src/plugins/api/PluginAPI.js +131 -0
  29. package/dist/esm/src/plugins/api/PluginAPI.js.map +1 -0
  30. package/dist/esm/src/plugins/core/PluginManager.js +46 -0
  31. package/dist/esm/src/plugins/core/PluginManager.js.map +1 -1
  32. package/dist/esm/src/server/FastServer.js +28 -15
  33. package/dist/esm/src/server/FastServer.js.map +1 -1
  34. package/dist/esm/src/server/ServerFactory.js +27 -22
  35. package/dist/esm/src/server/ServerFactory.js.map +1 -1
  36. package/dist/esm/src/server/components/fastapi/FileUploadManager.js +3 -2
  37. package/dist/esm/src/server/components/fastapi/FileUploadManager.js.map +1 -1
  38. package/dist/esm/src/server/components/fastapi/console/ConsoleInterceptor.js +74 -22
  39. package/dist/esm/src/server/components/fastapi/console/ConsoleInterceptor.js.map +1 -1
  40. package/dist/esm/src/server/components/fastapi/console/types.js +0 -1
  41. package/dist/esm/src/server/components/fastapi/console/types.js.map +1 -1
  42. package/dist/esm/src/server/const/default.js +75 -0
  43. package/dist/esm/src/server/const/default.js.map +1 -1
  44. package/dist/esm/src/server/handlers/NotFoundHandler.js +1 -1
  45. package/dist/index.d.ts +112 -109
  46. package/package.json +2 -1
  47. package/dist/cjs/src/plugins/core/PluginAPI.js +0 -80
  48. package/dist/cjs/src/plugins/core/PluginAPI.js.map +0 -1
  49. package/dist/cjs/src/server/utils/ConfigLoader.js +0 -306
  50. package/dist/cjs/src/server/utils/ConfigLoader.js.map +0 -1
  51. package/dist/esm/src/plugins/core/PluginAPI.js +0 -78
  52. package/dist/esm/src/plugins/core/PluginAPI.js.map +0 -1
  53. package/dist/esm/src/server/utils/ConfigLoader.js +0 -283
  54. package/dist/esm/src/server/utils/ConfigLoader.js.map +0 -1
@@ -1,283 +0,0 @@
1
- import * as fs from 'fs';
2
- import * as path from 'path';
3
-
4
- /**
5
- * XyPriss Configuration Loader
6
- *
7
- * Automatically loads configuration from external files (TypeScript or JSON)
8
- * Supports xypriss.config.ts, xypriss.config.js, and xypriss.config.json files
9
- *
10
- * @fileoverview Configuration loader for external config files
11
- * @version 1.0.0
12
- * @author XyPriss Team
13
- * @since 2025-01-01
14
- */
15
- /**
16
- * Configuration file names to search for (in order of preference)
17
- */
18
- const CONFIG_FILES = [
19
- "xypriss.config.ts",
20
- "xypriss.config.js",
21
- "xypriss.config.json",
22
- "xypriss.config.cjs",
23
- "xypriss.config.mjs",
24
- ];
25
- /**
26
- * Configuration loader class
27
- * Handles loading and validation of external configuration files
28
- */
29
- class ConfigLoader {
30
- /**
31
- * Load configuration from external files (synchronous - JSON only)
32
- *
33
- * Searches for JSON configuration files in the current working directory
34
- * and loads the first one found. This is a synchronous version for use in constructors.
35
- *
36
- * @param cwd - Current working directory (defaults to process.cwd())
37
- * @returns Loaded configuration or null if no config found
38
- *
39
- * @example
40
- * ```typescript
41
- * const configLoader = new ConfigLoader();
42
- * const config = configLoader.loadConfigSync();
43
- * if (config) {
44
- * console.log("Loaded config from:", config._source);
45
- * }
46
- * ```
47
- */
48
- loadConfigSync(cwd = process.cwd()) {
49
- // Only load JSON files synchronously for constructor use
50
- const jsonConfigPath = path.resolve(cwd, "xypriss.config.json");
51
- if (fs.existsSync(jsonConfigPath)) {
52
- try {
53
- const config = this.loadJsonConfig(jsonConfigPath);
54
- if (config && typeof config === "object") {
55
- // Add source information for debugging
56
- config._source = jsonConfigPath;
57
- return config;
58
- }
59
- }
60
- catch (error) {
61
- // Silently fail in constructor - config loading errors should not break initialization
62
- console.warn(`Warning: Failed to load JSON config from ${jsonConfigPath}:`, error);
63
- }
64
- }
65
- return null;
66
- }
67
- /**
68
- * Load configuration from external files (asynchronous)
69
- *
70
- * Searches for configuration files in the current working directory
71
- * and loads the first one found. Supports TypeScript, JavaScript, and JSON files.
72
- *
73
- * @param cwd - Current working directory (defaults to process.cwd())
74
- * @returns Promise resolving to loaded configuration or null if no config found
75
- *
76
- * @example
77
- * ```typescript
78
- * const configLoader = new ConfigLoader();
79
- * const config = await configLoader.loadConfig();
80
- * if (config) {
81
- * console.log("Loaded config from:", config._source);
82
- * }
83
- * ```
84
- */
85
- async loadConfig(cwd = process.cwd()) {
86
- for (const configFile of CONFIG_FILES) {
87
- const configPath = path.resolve(cwd, configFile);
88
- if (fs.existsSync(configPath)) {
89
- try {
90
- const config = await this.loadConfigFile(configPath);
91
- if (config && typeof config === "object") {
92
- // Add source information for debugging
93
- config._source = configPath;
94
- return config;
95
- }
96
- }
97
- catch (error) {
98
- console.warn(`Warning: Failed to load config from ${configPath}:`, error);
99
- // Continue to next file instead of failing
100
- }
101
- }
102
- }
103
- return null; // No configuration file found
104
- }
105
- /**
106
- * Load configuration from a specific file
107
- *
108
- * @param configPath - Absolute path to the configuration file
109
- * @returns Promise resolving to the loaded configuration
110
- * @private
111
- */
112
- async loadConfigFile(configPath) {
113
- const ext = path.extname(configPath).toLowerCase();
114
- switch (ext) {
115
- case ".json":
116
- return this.loadJsonConfig(configPath);
117
- case ".js":
118
- case ".cjs":
119
- return this.loadJsConfig(configPath);
120
- case ".mjs":
121
- return this.loadMjsConfig(configPath);
122
- case ".ts":
123
- return this.loadTsConfig(configPath);
124
- default:
125
- throw new Error(`Unsupported config file extension: ${ext}`);
126
- }
127
- }
128
- /**
129
- * Load JSON configuration file
130
- *
131
- * @param configPath - Path to JSON config file
132
- * @returns Parsed JSON configuration
133
- * @private
134
- */
135
- loadJsonConfig(configPath) {
136
- const content = fs.readFileSync(configPath, "utf-8");
137
- return JSON.parse(content);
138
- }
139
- /**
140
- * Load JavaScript configuration file
141
- *
142
- * @param configPath - Path to JS config file
143
- * @returns Configuration object exported by the JS file
144
- * @private
145
- */
146
- async loadJsConfig(configPath) {
147
- // For CommonJS and ESM files, we need dynamic import which works for both
148
- try {
149
- // Use dynamic import which works for both CommonJS and ESM
150
- const config = await import(configPath);
151
- // Handle both default export and named exports
152
- return config.default || config;
153
- }
154
- catch (error) {
155
- // Fallback to require for CommonJS in environments where dynamic import fails
156
- try {
157
- // Clear require cache to allow reloading
158
- delete require.cache[require.resolve(configPath)];
159
- const config = require(configPath);
160
- // Handle both default export and module.exports
161
- return config.default || config;
162
- }
163
- catch (fallbackError) {
164
- throw new Error(`Failed to load JS config: ${error}. Fallback also failed: ${fallbackError}`);
165
- }
166
- }
167
- }
168
- /**
169
- * Load ES Module configuration file
170
- *
171
- * @param configPath - Path to MJS config file
172
- * @returns Configuration object exported by the MJS file
173
- * @private
174
- */
175
- async loadMjsConfig(configPath) {
176
- // For ES modules, we need dynamic import
177
- try {
178
- const config = await import(configPath);
179
- return config.default || config;
180
- }
181
- catch (error) {
182
- throw new Error(`Failed to load MJS config: ${error}`);
183
- }
184
- }
185
- /**
186
- * Load TypeScript configuration file
187
- *
188
- * @param configPath - Path to TS config file
189
- * @returns Configuration object exported by the TS file
190
- * @private
191
- */
192
- async loadTsConfig(configPath) {
193
- try {
194
- // First, try to load as JavaScript (if user compiled it)
195
- const jsPath = configPath.replace(/\.ts$/, ".js");
196
- if (fs.existsSync(jsPath)) {
197
- return this.loadJsConfig(jsPath);
198
- }
199
- // Try dynamic import directly (works if ts-node or similar is available)
200
- const config = await import(configPath);
201
- return config.default || config;
202
- }
203
- catch (error) {
204
- // If direct import fails, try to compile with ts-node if available
205
- try {
206
- // Check if ts-node is available
207
- require.resolve("ts-node");
208
- // Register ts-node for TypeScript compilation
209
- require("ts-node/register");
210
- // Clear require cache and load the TypeScript file
211
- delete require.cache[require.resolve(configPath)];
212
- const config = require(configPath);
213
- return config.default || config;
214
- }
215
- catch (tsNodeError) {
216
- // If ts-node is not available or fails, provide helpful error message
217
- throw new Error(`Failed to load TS config from ${configPath}. ` +
218
- `Please ensure ts-node is installed (npm install ts-node) or compile to JS first. ` +
219
- `Original error: ${error.message}`);
220
- }
221
- }
222
- }
223
- /**
224
- * Validate configuration object
225
- *
226
- * Performs basic validation on the loaded configuration
227
- *
228
- * @param config - Configuration object to validate
229
- * @returns True if configuration is valid
230
- *
231
- * @example
232
- * ```typescript
233
- * const loader = new ConfigLoader();
234
- * const config = await loader.loadConfig();
235
- * if (config && loader.validateConfig(config)) {
236
- * console.log("Config is valid");
237
- * }
238
- * ```
239
- */
240
- validateConfig(config) {
241
- // Basic validation - check if it's an object
242
- if (!config || typeof config !== "object") {
243
- return false;
244
- }
245
- // Check for required structure (at least one valid property)
246
- const validKeys = [
247
- "env", "server", "security", "performance", "monitoring",
248
- "cache", "cluster", "plugins", "requestManagement", "fileUpload"
249
- ];
250
- return validKeys.some(key => key in config);
251
- }
252
- /**
253
- * Get list of available configuration files in a directory
254
- *
255
- * @param cwd - Directory to search (defaults to process.cwd())
256
- * @returns Array of available configuration file names
257
- *
258
- * @example
259
- * ```typescript
260
- * const loader = new ConfigLoader();
261
- * const files = loader.getAvailableConfigFiles();
262
- * console.log("Available config files:", files);
263
- * ```
264
- */
265
- getAvailableConfigFiles(cwd = process.cwd()) {
266
- const available = [];
267
- for (const configFile of CONFIG_FILES) {
268
- const configPath = path.resolve(cwd, configFile);
269
- if (fs.existsSync(configPath)) {
270
- available.push(configFile);
271
- }
272
- }
273
- return available;
274
- }
275
- }
276
- /**
277
- * Default configuration loader instance
278
- * Can be used directly without creating a new instance
279
- */
280
- const configLoader = new ConfigLoader();
281
-
282
- export { ConfigLoader, configLoader };
283
- //# sourceMappingURL=ConfigLoader.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ConfigLoader.js","sources":["../../../../../src/server/utils/ConfigLoader.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}