webspresso 0.0.106 → 0.0.108

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 (118) hide show
  1. package/.agents/AGENTS.md +4 -1
  2. package/.agents/CACHE.md +1 -0
  3. package/.agents/CONTEXT.md +152 -0
  4. package/.agents/ORM.md +74 -0
  5. package/.agents/SHUTDOWN.md +8 -1
  6. package/.agents/skills/webspresso-framework/SKILL.md +2 -1
  7. package/.agents/skills/webspresso-orm-and-database/SKILL.md +9 -0
  8. package/.agents/skills/webspresso-routing-and-api/SKILL.md +18 -2
  9. package/.agents/skills/webspresso-services/SKILL.md +36 -3
  10. package/AGENTS.md +6 -3
  11. package/bin/webspresso.js +17 -7
  12. package/core/app.js +45 -11
  13. package/core/applySchema.js +3 -72
  14. package/core/auth/index.js +4 -1
  15. package/core/auth/jwt.js +85 -13
  16. package/core/auth/magic-link.js +23 -5
  17. package/core/auth/manager.js +7 -1
  18. package/core/auth/redis-session.js +62 -25
  19. package/core/auth/session-manager.js +28 -2
  20. package/core/auth/sessions.js +182 -52
  21. package/core/cache/lru.js +10 -0
  22. package/core/cache/tagged-lru.js +4 -0
  23. package/core/compileSchema.js +3 -68
  24. package/core/compression/compressible.js +53 -6
  25. package/core/compression/negotiate.js +31 -12
  26. package/core/console/eval.js +4 -1
  27. package/core/content/service.js +1 -0
  28. package/core/context/app-context.js +201 -0
  29. package/core/context/index.js +55 -0
  30. package/core/context/request.js +241 -0
  31. package/core/errors/domain.js +20 -2
  32. package/core/errors/http.js +1 -0
  33. package/core/events/dispatcher.js +144 -15
  34. package/core/events/signal.js +9 -0
  35. package/core/health/probes.js +12 -2
  36. package/core/http/hono-adapter.js +1 -1
  37. package/core/http/index.js +10 -1
  38. package/core/http/pipeline.js +519 -334
  39. package/core/index.js +36 -2
  40. package/core/mail/mailer.js +1 -1
  41. package/core/orm/eager-loader.js +170 -55
  42. package/core/orm/index.js +25 -47
  43. package/core/orm/json-fields.js +44 -13
  44. package/core/orm/model.js +18 -1
  45. package/core/orm/query-builder.js +33 -15
  46. package/core/orm/repository.js +59 -12
  47. package/core/orm/schema-helpers.js +59 -0
  48. package/core/orm/scopes.js +54 -4
  49. package/core/orm/transaction.js +109 -14
  50. package/core/plugins/index.js +8 -0
  51. package/core/plugins/plugin-manager.js +1098 -0
  52. package/core/queue/manager.js +55 -27
  53. package/core/rate-limit/stores/memory.js +23 -10
  54. package/core/resilience/circuit-breaker.js +34 -14
  55. package/core/schema-cache.js +2 -64
  56. package/core/services/builtins/auth.js +273 -0
  57. package/core/services/builtins/exchange.js +229 -0
  58. package/core/services/builtins/file-manager.js +178 -0
  59. package/core/services/builtins/mail.js +134 -0
  60. package/core/services/builtins/media.js +196 -0
  61. package/core/services/builtins/system.js +219 -0
  62. package/core/services/discovery.js +133 -0
  63. package/core/services/executor.js +629 -0
  64. package/core/services/index.js +114 -0
  65. package/core/services/loader.js +161 -0
  66. package/core/services/memoize.js +408 -0
  67. package/core/services/registry.js +731 -0
  68. package/core/services/validator.js +424 -0
  69. package/core/shutdown/shutdown-manager.js +194 -114
  70. package/core/ssr/stream.js +109 -16
  71. package/core/stream/text-stream.js +45 -4
  72. package/core/studio/inspector.js +9 -1
  73. package/core/studio/server.js +24 -8
  74. package/core/utils/index.js +110 -0
  75. package/core/utils/string.js +77 -16
  76. package/core/utils/timeout.js +4 -0
  77. package/core/validation/apply.js +74 -0
  78. package/core/validation/cache.js +66 -0
  79. package/core/validation/compiler.js +77 -0
  80. package/core/validation/index.js +40 -1
  81. package/index.d.ts +249 -12
  82. package/index.js +68 -20
  83. package/package.json +18 -8
  84. package/plugins/admin-panel/client/parts/07-model-list.js +5 -2
  85. package/plugins/admin-panel/index.js +24 -11
  86. package/plugins/admin-panel/modules/user-management.js +3 -2
  87. package/plugins/csrf/index.js +2 -1
  88. package/plugins/dashboard/index.js +27 -7
  89. package/src/app-context.js +4 -188
  90. package/src/dev/typegen.js +1 -1
  91. package/src/file-router.js +12 -3
  92. package/src/plugin-manager.js +5 -861
  93. package/src/server.js +30 -34
  94. package/src/services/builtins/auth.js +2 -273
  95. package/src/services/builtins/exchange.js +2 -229
  96. package/src/services/builtins/file-manager.js +2 -178
  97. package/src/services/builtins/mail.js +2 -134
  98. package/src/services/builtins/media.js +2 -196
  99. package/src/services/builtins/system.js +2 -219
  100. package/src/services/discovery.js +2 -125
  101. package/src/services/executor.js +2 -362
  102. package/src/services/index.js +4 -60
  103. package/src/services/loader.js +2 -0
  104. package/src/services/memoize.js +2 -234
  105. package/src/services/registry.js +2 -314
  106. package/src/services/validator.js +2 -273
  107. package/core/utils/array.js +0 -12
  108. package/core/utils/base64url.js +0 -8
  109. package/core/utils/ensure-leading-slash.js +0 -6
  110. package/core/utils/escape-html.js +0 -7
  111. package/core/utils/escape-regexp.js +0 -7
  112. package/core/utils/get-client-ip.js +0 -6
  113. package/core/utils/hmac.js +0 -6
  114. package/core/utils/random.js +0 -9
  115. package/core/utils/safe-compare.js +0 -3
  116. package/core/utils/sha256.js +0 -6
  117. package/core/utils/strip-trailing-slash.js +0 -6
  118. package/core/utils/walk.js +0 -7
@@ -324,7 +324,7 @@ class EventDispatcher extends EventEmitter {
324
324
  } catch (err) {
325
325
  // Emit error on dispatcher or log
326
326
  if (this.listenerCount('error') > 0) {
327
- super.emit('error', err);
327
+ this.emit('error', err);
328
328
  } else if (this.logger && typeof this.logger.error === 'function') {
329
329
  this.logger.error(`[EventDispatcher] Error in listener for event "${event}":`, err);
330
330
  }
@@ -355,10 +355,19 @@ class EventDispatcher extends EventEmitter {
355
355
  const meta = { event, sender, timestamp: Date.now() };
356
356
 
357
357
  const promises = listeners.map(async (listener) => {
358
- if (listener.isAny) {
359
- return listener.handler(event, payload, meta);
358
+ try {
359
+ if (listener.isAny) {
360
+ return await listener.handler(event, payload, meta);
361
+ }
362
+ return await listener.handler(payload, meta);
363
+ } catch (err) {
364
+ if (this.listenerCount('error') > 0) {
365
+ this.emit('error', err);
366
+ } else if (this.logger && typeof this.logger.error === 'function') {
367
+ this.logger.error(`[EventDispatcher] Error in async listener for event "${event}":`, err);
368
+ }
369
+ throw err;
360
370
  }
361
- return listener.handler(payload, meta);
362
371
  });
363
372
 
364
373
  return Promise.allSettled(promises);
@@ -399,10 +408,19 @@ class EventDispatcher extends EventEmitter {
399
408
  const results = [];
400
409
 
401
410
  for (const listener of listeners) {
402
- const res = listener.isAny
403
- ? await listener.handler(event, payload, meta)
404
- : await listener.handler(payload, meta);
405
- results.push(res);
411
+ try {
412
+ const res = listener.isAny
413
+ ? await listener.handler(event, payload, meta)
414
+ : await listener.handler(payload, meta);
415
+ results.push(res);
416
+ } catch (err) {
417
+ if (this.listenerCount('error') > 0) {
418
+ this.emit('error', err);
419
+ } else if (this.logger && typeof this.logger.error === 'function') {
420
+ this.logger.error(`[EventDispatcher] Error in serial listener for event "${event}":`, err);
421
+ }
422
+ throw err;
423
+ }
406
424
  }
407
425
 
408
426
  return results;
@@ -429,18 +447,113 @@ class EventDispatcher extends EventEmitter {
429
447
  let currentData = payload;
430
448
 
431
449
  for (const listener of listeners) {
432
- const res = listener.isAny
433
- ? await listener.handler(event, currentData, meta)
434
- : await listener.handler(currentData, meta);
450
+ try {
451
+ const res = listener.isAny
452
+ ? await listener.handler(event, currentData, meta)
453
+ : await listener.handler(currentData, meta);
435
454
 
436
- if (res !== undefined) {
437
- currentData = res;
455
+ if (res !== undefined) {
456
+ currentData = res;
457
+ }
458
+ } catch (err) {
459
+ if (this.listenerCount('error') > 0) {
460
+ this.emit('error', err);
461
+ } else if (this.logger && typeof this.logger.error === 'function') {
462
+ this.logger.error(`[EventDispatcher] Error in waterfall listener for event "${event}":`, err);
463
+ }
464
+ throw err;
438
465
  }
439
466
  }
440
467
 
441
468
  return currentData;
442
469
  }
443
470
 
471
+ /**
472
+ * Asynchronously wait for a matching event to be emitted
473
+ * @param {string} event - Event name or pattern
474
+ * @param {Object|number|Function} [optionsOrTimeout=5000] - Timeout in ms, predicate, or options
475
+ * @param {number} [optionsOrTimeout.timeout=5000] - Timeout in ms (0 for indefinite)
476
+ * @param {Function} [optionsOrTimeout.filter] - Predicate (data, meta) => boolean
477
+ * @param {AbortSignal} [optionsOrTimeout.signal] - AbortSignal for cancellation
478
+ * @param {any} [optionsOrTimeout.sender] - Filter by sender
479
+ * @returns {Promise<{ data: any, meta: Object }>}
480
+ */
481
+ waitFor(event, optionsOrTimeout = {}) {
482
+ let timeoutMs = 5000;
483
+ let filter = null;
484
+ let signal = null;
485
+ let sender = undefined;
486
+
487
+ if (typeof optionsOrTimeout === 'number') {
488
+ timeoutMs = optionsOrTimeout;
489
+ } else if (typeof optionsOrTimeout === 'function') {
490
+ filter = optionsOrTimeout;
491
+ } else if (typeof optionsOrTimeout === 'object' && optionsOrTimeout !== null) {
492
+ if (optionsOrTimeout.timeout !== undefined) timeoutMs = optionsOrTimeout.timeout;
493
+ if (typeof optionsOrTimeout.filter === 'function') filter = optionsOrTimeout.filter;
494
+ if (optionsOrTimeout.signal) signal = optionsOrTimeout.signal;
495
+ if (optionsOrTimeout.sender !== undefined) sender = optionsOrTimeout.sender;
496
+ }
497
+
498
+ return new Promise((resolve, reject) => {
499
+ if (signal && signal.aborted) {
500
+ return reject(new Error(`waitFor('${event}') aborted before execution`));
501
+ }
502
+
503
+ let timeoutTimer = null;
504
+ let unsubscribe = null;
505
+ let abortHandler = null;
506
+
507
+ const cleanup = () => {
508
+ if (timeoutTimer) {
509
+ clearTimeout(timeoutTimer);
510
+ timeoutTimer = null;
511
+ }
512
+ if (typeof unsubscribe === 'function') {
513
+ unsubscribe();
514
+ unsubscribe = null;
515
+ }
516
+ if (signal && abortHandler) {
517
+ signal.removeEventListener('abort', abortHandler);
518
+ abortHandler = null;
519
+ }
520
+ };
521
+
522
+ if (timeoutMs > 0) {
523
+ timeoutTimer = setTimeout(() => {
524
+ cleanup();
525
+ reject(new Error(`Timeout of ${timeoutMs}ms exceeded while waiting for event '${event}'`));
526
+ }, timeoutMs);
527
+ if (timeoutTimer && typeof timeoutTimer.unref === 'function') {
528
+ timeoutTimer.unref();
529
+ }
530
+ }
531
+
532
+ if (signal) {
533
+ abortHandler = () => {
534
+ cleanup();
535
+ reject(new Error(`waitFor('${event}') was aborted`));
536
+ };
537
+ signal.addEventListener('abort', abortHandler, { once: true });
538
+ }
539
+
540
+ const handler = (data, meta) => {
541
+ try {
542
+ if (filter && !filter(data, meta)) {
543
+ return;
544
+ }
545
+ cleanup();
546
+ resolve({ data, meta });
547
+ } catch (err) {
548
+ cleanup();
549
+ reject(err);
550
+ }
551
+ };
552
+
553
+ unsubscribe = this.on(event, handler, { sender });
554
+ });
555
+ }
556
+
444
557
  /**
445
558
  * Set or update background queue manager for job dispatching
446
559
  * @param {any} queueManager
@@ -462,11 +575,27 @@ class EventDispatcher extends EventEmitter {
462
575
  listenAndQueue(event, jobName, queueOptions = {}) {
463
576
  return this.on(event, (data) => {
464
577
  if (!this.queue || typeof this.queue.dispatch !== 'function') {
465
- throw new Error(
578
+ const err = new Error(
466
579
  `[EventDispatcher] Cannot queue job '${jobName}' for event '${event}'. No QueueManager is attached.`
467
580
  );
581
+ if (this.listenerCount('error') > 0) {
582
+ this.emit('error', err);
583
+ } else if (this.logger && typeof this.logger.error === 'function') {
584
+ this.logger.error(err.message);
585
+ }
586
+ return Promise.reject(err);
587
+ }
588
+ const dispatchPromise = this.queue.dispatch(jobName, data, queueOptions);
589
+ if (dispatchPromise && typeof dispatchPromise.catch === 'function') {
590
+ dispatchPromise.catch((dispatchErr) => {
591
+ if (this.listenerCount('error') > 0) {
592
+ this.emit('error', dispatchErr);
593
+ } else if (this.logger && typeof this.logger.error === 'function') {
594
+ this.logger.error(`[EventDispatcher] Failed to dispatch queued job '${jobName}':`, dispatchErr);
595
+ }
596
+ });
468
597
  }
469
- return this.queue.dispatch(jobName, data, queueOptions);
598
+ return dispatchPromise;
470
599
  });
471
600
  }
472
601
 
@@ -79,6 +79,15 @@ class Signal {
79
79
  async dispatch(data, options = {}) {
80
80
  return this.sendAsync(data, options);
81
81
  }
82
+
83
+ /**
84
+ * Asynchronously wait for this signal to be emitted
85
+ * @param {Object|number|Function} [optionsOrTimeout]
86
+ * @returns {Promise<{ data: any, meta: Object }>}
87
+ */
88
+ waitFor(optionsOrTimeout) {
89
+ return this.dispatcher.waitFor(this.name, optionsOrTimeout);
90
+ }
82
91
  }
83
92
 
84
93
  /**
@@ -112,9 +112,15 @@ async function probeDatabase(db, timeoutMs = 3000) {
112
112
  timer = setTimeout(() => {
113
113
  reject(new Error(`Database ping timed out after ${timeoutMs}ms`));
114
114
  }, timeoutMs);
115
+ if (typeof timer?.unref === 'function') timer.unref();
115
116
  });
116
117
 
117
- await Promise.race([knex.raw('SELECT 1'), timeoutPromise]);
118
+ const pingPromise = Promise.resolve(knex.raw('SELECT 1'));
119
+ if (typeof pingPromise.catch === 'function') {
120
+ pingPromise.catch(() => {});
121
+ }
122
+
123
+ await Promise.race([pingPromise, timeoutPromise]);
118
124
  const latencyMs = Date.now() - startTime;
119
125
  return { status: 'up', latencyMs };
120
126
  } catch (err) {
@@ -170,9 +176,13 @@ async function probeCustomChecks(checks = {}, context = {}, timeoutMs = 3000) {
170
176
  try {
171
177
  const timeoutPromise = new Promise((_, reject) => {
172
178
  timer = setTimeout(() => reject(new Error(`Health check "${name}" timed out after ${timeoutMs}ms`)), timeoutMs);
179
+ if (typeof timer?.unref === 'function') timer.unref();
173
180
  });
174
181
 
175
- const res = await Promise.race([Promise.resolve(checkFn(context)), timeoutPromise]);
182
+ const checkPromise = Promise.resolve().then(() => checkFn(context));
183
+ checkPromise.catch(() => {});
184
+
185
+ const res = await Promise.race([checkPromise, timeoutPromise]);
176
186
  const latencyMs = Date.now() - startTime;
177
187
 
178
188
  if (res === false || (res && typeof res === 'object' && res.status === 'down')) {
@@ -341,7 +341,7 @@ class HonoHttpAdapter extends HttpAdapter {
341
341
  route(method, path, ...handlers) {
342
342
  const m = (method || '').toLowerCase();
343
343
  // Normalize Express bracket parameters: e.g. /api/notes/[id] -> /api/notes/:id
344
- const honoPath = path.replace(/\[([^\]]+)\]/g, ':$1');
344
+ const honoPath = typeof path === 'string' ? path.replace(/\[([^\[\]]+)\]/g, ':$1') : path;
345
345
 
346
346
  for (const handler of handlers) {
347
347
  if (typeof handler !== 'function') continue;
@@ -7,7 +7,14 @@
7
7
 
8
8
  const { HttpAdapter } = require('./adapter');
9
9
  const { ExpressHttpAdapter, createExpressHttpAdapter } = require('./express-adapter');
10
- const { runMiddlewares, enrichRouteError, executeApiPipeline, executePagePipeline } = require('./pipeline');
10
+ const {
11
+ createPipelineRunner,
12
+ runMiddlewares,
13
+ enrichRouteError,
14
+ validateRequestInput,
15
+ executeApiPipeline,
16
+ executePagePipeline,
17
+ } = require('./pipeline');
11
18
 
12
19
  let _honoModule = null;
13
20
  function getHonoModule() {
@@ -21,8 +28,10 @@ module.exports = {
21
28
  HttpAdapter,
22
29
  ExpressHttpAdapter,
23
30
  createExpressHttpAdapter,
31
+ createPipelineRunner,
24
32
  runMiddlewares,
25
33
  enrichRouteError,
34
+ validateRequestInput,
26
35
  executeApiPipeline,
27
36
  executePagePipeline,
28
37
  };