webspresso 0.0.104 → 0.0.106

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 (233) hide show
  1. package/.agents/AGENTS.md +21 -2
  2. package/.agents/ARCHITECTURE.md +23 -0
  3. package/.agents/CACHE.md +147 -0
  4. package/.agents/CLI.md +220 -8
  5. package/.agents/EARLY_HINTS.md +120 -0
  6. package/.agents/FLAGS.md +118 -0
  7. package/.agents/HEALTH.md +118 -0
  8. package/.agents/LIMITS.md +109 -0
  9. package/.agents/LOGGING.md +93 -0
  10. package/.agents/METRICS.md +127 -0
  11. package/.agents/MIGRATION_JOBS.md +95 -0
  12. package/.agents/ORM.md +155 -1
  13. package/.agents/PLUGINS.md +38 -3
  14. package/.agents/QUEUE.md +42 -0
  15. package/.agents/RATE_LIMIT.md +147 -0
  16. package/.agents/RESILIENCE.md +235 -0
  17. package/.agents/SCALE_OUT.md +109 -0
  18. package/.agents/SECRETS.md +117 -0
  19. package/AGENTS.md +16 -0
  20. package/README.md +2 -2
  21. package/bin/commands/add-aws.js +396 -0
  22. package/bin/commands/add-ci.js +523 -0
  23. package/bin/commands/add-cloudflare.js +240 -0
  24. package/bin/commands/add-cloudrun.js +381 -0
  25. package/bin/commands/add-docker.js +6 -6
  26. package/bin/commands/add-migration-job.js +396 -0
  27. package/bin/commands/assets-sync.js +209 -0
  28. package/bin/commands/client-generate.js +52 -0
  29. package/bin/commands/console.js +53 -0
  30. package/bin/commands/db-migrate.js +47 -2
  31. package/bin/commands/db-studio.js +84 -0
  32. package/bin/commands/deploy-check.js +242 -13
  33. package/bin/commands/dev.js +1 -1
  34. package/bin/commands/export.js +87 -0
  35. package/bin/commands/new.js +5 -5
  36. package/bin/commands/openapi.js +1 -1
  37. package/bin/commands/secrets-pull.js +208 -0
  38. package/bin/commands/start.js +1 -1
  39. package/bin/utils/db.js +7 -1
  40. package/bin/utils/project.js +2 -2
  41. package/bin/webspresso.js +22 -0
  42. package/core/app.js +421 -0
  43. package/core/auth/authenticate.js +93 -0
  44. package/core/auth/hash.js +5 -4
  45. package/core/auth/index.js +34 -4
  46. package/core/auth/jwt.js +5 -54
  47. package/core/auth/magic-link.js +4 -5
  48. package/core/auth/manager.js +53 -10
  49. package/core/auth/middleware.js +16 -68
  50. package/core/auth/oauth.js +8 -17
  51. package/core/auth/redis-session.js +1008 -0
  52. package/core/auth/sessions.js +156 -0
  53. package/core/auth/totp.js +2 -1
  54. package/core/cache/byte-size.js +123 -0
  55. package/core/cache/cdn.js +296 -0
  56. package/core/cache/index.js +33 -0
  57. package/core/cache/lru.js +477 -0
  58. package/core/cache/tagged-lru.js +354 -0
  59. package/core/commands/registry.js +6 -20
  60. package/core/console/commands.js +148 -0
  61. package/core/console/context.js +260 -0
  62. package/core/console/eval.js +70 -0
  63. package/core/console/index.js +22 -0
  64. package/core/console/repl.js +102 -0
  65. package/core/early-hints/index.js +267 -0
  66. package/core/errors/domain.js +49 -0
  67. package/core/errors/http.js +31 -0
  68. package/core/errors/index.js +10 -0
  69. package/core/errors/normalize.js +88 -2
  70. package/core/events/discovery.js +6 -24
  71. package/core/events/dispatcher.js +9 -7
  72. package/core/events/signal.js +7 -0
  73. package/core/export/discovery.js +191 -0
  74. package/core/export/exporter.js +277 -0
  75. package/core/export/index.js +24 -0
  76. package/core/flags/evaluator.js +252 -0
  77. package/core/flags/hasher.js +37 -0
  78. package/core/flags/index.js +21 -0
  79. package/core/flags/manager.js +263 -0
  80. package/core/flags/store.js +126 -0
  81. package/core/health/index.js +41 -0
  82. package/core/health/middleware.js +213 -0
  83. package/core/health/normalize.js +140 -0
  84. package/core/health/probes.js +203 -0
  85. package/core/http/adapter.js +74 -0
  86. package/core/http/express-adapter.js +46 -0
  87. package/core/http/hono-adapter.js +531 -0
  88. package/core/http/index.js +41 -0
  89. package/core/http/pipeline.js +485 -0
  90. package/core/index.js +336 -0
  91. package/core/limits/index.js +34 -0
  92. package/core/limits/middleware.js +325 -0
  93. package/core/limits/normalize.js +222 -0
  94. package/core/logger/formatters.js +264 -0
  95. package/core/logger/index.js +260 -0
  96. package/core/logger/trace.js +137 -0
  97. package/core/metrics/collectors.js +125 -0
  98. package/core/metrics/index.js +45 -0
  99. package/core/metrics/middleware.js +230 -0
  100. package/core/metrics/registry.js +366 -0
  101. package/core/orm/batch.js +70 -0
  102. package/core/orm/cache/fingerprint.js +2 -2
  103. package/core/orm/cache/memory-provider.js +27 -110
  104. package/core/orm/d1.js +265 -0
  105. package/core/orm/index.js +176 -13
  106. package/core/orm/json-fields.js +22 -8
  107. package/core/orm/migrate-cloud.js +194 -0
  108. package/core/orm/model.js +10 -0
  109. package/core/orm/pool.js +97 -0
  110. package/core/orm/query-builder.js +72 -9
  111. package/core/orm/repository.js +318 -19
  112. package/core/orm/schema-helpers.js +8 -10
  113. package/core/orm/scopes.js +321 -1
  114. package/core/orm/transaction.js +10 -2
  115. package/core/orm/utils.js +4 -86
  116. package/core/queue/adapters/cloudflare.js +131 -0
  117. package/core/queue/adapters/database.js +4 -8
  118. package/core/queue/adapters/pubsub.js +400 -0
  119. package/core/queue/adapters/sqs.js +419 -0
  120. package/core/queue/adapters/wait-until.js +77 -0
  121. package/core/queue/index.js +8 -0
  122. package/core/queue/manager.js +66 -41
  123. package/core/rate-limit/index.js +22 -0
  124. package/core/rate-limit/limiter.js +219 -0
  125. package/core/rate-limit/stores/memory.js +129 -0
  126. package/core/rate-limit/stores/redis.js +151 -0
  127. package/core/rate-limit/utils.js +112 -0
  128. package/core/resilience/circuit-breaker.js +422 -0
  129. package/core/resilience/errors.js +63 -0
  130. package/core/resilience/index.js +53 -0
  131. package/core/resilience/registry.js +97 -0
  132. package/core/resilience/retry.js +203 -0
  133. package/core/schema-cache.js +9 -2
  134. package/core/secrets/index.js +113 -0
  135. package/core/secrets/manager.js +308 -0
  136. package/core/secrets/providers/aws.js +288 -0
  137. package/core/secrets/providers/env.js +44 -0
  138. package/core/secrets/providers/gcp.js +307 -0
  139. package/core/secrets/providers/memory.js +76 -0
  140. package/core/shutdown/http-adapter.js +4 -1
  141. package/core/shutdown/shutdown-manager.js +129 -19
  142. package/core/stream/index.js +19 -0
  143. package/core/stream/text-stream.js +326 -0
  144. package/core/studio/index.js +43 -0
  145. package/core/studio/inspector.js +258 -0
  146. package/core/studio/server.js +325 -0
  147. package/core/studio/ui.js +681 -0
  148. package/core/utils/array.js +12 -0
  149. package/core/utils/base64url.js +8 -0
  150. package/core/utils/crypto.js +118 -0
  151. package/core/utils/ensure-leading-slash.js +6 -0
  152. package/core/utils/escape-regexp.js +7 -0
  153. package/core/utils/fetch.js +6 -5
  154. package/core/utils/fs.js +144 -0
  155. package/core/utils/hmac.js +6 -0
  156. package/core/utils/json.js +98 -0
  157. package/core/utils/object.js +106 -0
  158. package/core/utils/random.js +9 -0
  159. package/core/utils/regex.js +77 -0
  160. package/core/utils/sha256.js +6 -0
  161. package/core/utils/string.js +87 -0
  162. package/core/utils/strip-trailing-slash.js +6 -0
  163. package/core/utils/time.js +96 -0
  164. package/core/utils/timeout.js +348 -0
  165. package/core/utils/url.js +106 -0
  166. package/core/utils/walk.js +7 -0
  167. package/index.d.ts +1549 -2
  168. package/index.js +272 -2
  169. package/package.json +3 -2
  170. package/plugins/admin-panel/core/api-extensions.js +2 -5
  171. package/plugins/admin-panel/index.js +13 -6
  172. package/plugins/admin-panel/modules/menu.js +1 -1
  173. package/plugins/api-key/crypto.js +3 -3
  174. package/plugins/api-key/index.js +3 -2
  175. package/plugins/api-key/scopes.js +5 -7
  176. package/plugins/audit-log/api-handlers.js +6 -15
  177. package/plugins/audit-log/index.js +3 -1
  178. package/plugins/audit-log/parse.js +3 -3
  179. package/plugins/basic-auth/index.js +3 -2
  180. package/plugins/cors.js +3 -2
  181. package/plugins/csrf/index.js +9 -12
  182. package/plugins/csv/index.js +8 -5
  183. package/plugins/dashboard/app.js +2 -2
  184. package/plugins/dashboard/index.js +5 -5
  185. package/plugins/data-exchange/record-selection.js +2 -5
  186. package/plugins/email/api-handlers.js +5 -18
  187. package/plugins/email/auth-bridge.js +3 -2
  188. package/plugins/email/index.js +11 -9
  189. package/plugins/health-check.js +2 -1
  190. package/plugins/index.js +5 -0
  191. package/plugins/lazy.js +5 -6
  192. package/plugins/mcp/discovery.js +18 -17
  193. package/plugins/polar/src/api.js +2 -1
  194. package/plugins/polar/src/webhooks.js +5 -6
  195. package/plugins/queue/index.js +18 -2
  196. package/plugins/rate-limit/index.js +3 -1
  197. package/plugins/redirect/index.js +16 -9
  198. package/plugins/rls/index.js +170 -0
  199. package/plugins/seo-checker/index.js +2 -2
  200. package/plugins/site-analytics/index.js +3 -1
  201. package/plugins/site-analytics/tracking.js +2 -2
  202. package/plugins/sitemap.js +3 -2
  203. package/plugins/swagger.js +12 -5
  204. package/plugins/upload/gcs-provider.js +148 -0
  205. package/plugins/upload/index.js +136 -77
  206. package/plugins/upload/orphan-pruner.js +4 -3
  207. package/plugins/upload/s3-provider.js +257 -0
  208. package/plugins/webhooks/crypto.js +6 -11
  209. package/plugins/webhooks/dispatcher.js +8 -8
  210. package/plugins/webhooks/index.js +33 -23
  211. package/plugins/webhooks/matcher.js +7 -11
  212. package/plugins/webhooks/sender.js +8 -11
  213. package/plugins/xlsx/index.js +7 -5
  214. package/src/api/api-loader.js +12 -95
  215. package/src/api/define-api.js +1 -0
  216. package/src/app-context.js +41 -5
  217. package/src/client-runtime/constants.js +10 -0
  218. package/src/client-runtime/mount.js +2 -3
  219. package/src/dev/banner.js +6 -2
  220. package/src/dev/client-gen.js +458 -0
  221. package/src/discovery/scan-routes.js +5 -2
  222. package/src/file-router.js +3 -3
  223. package/src/helpers.js +212 -24
  224. package/src/modules/module-discovery.js +1 -9
  225. package/src/pages/page-loader.js +13 -154
  226. package/src/plugin-manager.js +99 -18
  227. package/src/server.js +335 -133
  228. package/src/services/discovery.js +19 -40
  229. package/src/services/executor.js +95 -25
  230. package/src/services/memoize.js +3 -25
  231. package/src/services/registry.js +15 -1
  232. package/src/services/validator.js +38 -20
  233. package/src/template/precompile.js +8 -19
package/core/index.js ADDED
@@ -0,0 +1,336 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * Webspresso Core
5
+ * Framework-agnostic kernel providing services, ORM, events, cache, resilience,
6
+ * validation, and lifecycle coordination with zero Express dependencies.
7
+ *
8
+ * @module core
9
+ */
10
+
11
+ const { CoreApp, createCoreApp } = require('./app');
12
+ const {
13
+ createServiceRegistry,
14
+ defineService,
15
+ ServiceRegistry,
16
+ executeService,
17
+ discoverServices,
18
+ filePathToServiceName,
19
+ toCamelCase,
20
+ validateServiceInput,
21
+ memoize,
22
+ parseTtlMs,
23
+ stableCacheKey,
24
+ sanitizeInput,
25
+ maskSensitiveData,
26
+ } = require('../src/services');
27
+
28
+ const { ShutdownManager } = require('./shutdown');
29
+ const errors = require('./errors');
30
+ const cache = require('./cache');
31
+ const resilience = require('./resilience');
32
+ const events = require('./events');
33
+ const secrets = require('./secrets');
34
+ const metrics = require('./metrics');
35
+ const {
36
+ PluginManager,
37
+ createPluginManager,
38
+ getPluginManager,
39
+ resetPluginManager,
40
+ } = require('../src/plugin-manager');
41
+
42
+ // Lazy-loaded ORM accessor
43
+ let _orm = null;
44
+ function getOrm() {
45
+ if (!_orm) {
46
+ _orm = require('./orm');
47
+ }
48
+ return _orm;
49
+ }
50
+
51
+ module.exports = {
52
+ // Core Application Container
53
+ CoreApp,
54
+ createCoreApp,
55
+
56
+ // Services Layer
57
+ createServiceRegistry,
58
+ defineService,
59
+ service: defineService,
60
+ ServiceRegistry,
61
+ executeService,
62
+ discoverServices,
63
+ filePathToServiceName,
64
+ toCamelCase,
65
+ validateServiceInput,
66
+ memoize,
67
+ parseTtlMs,
68
+ stableCacheKey,
69
+ sanitizeInput,
70
+ maskSensitiveData,
71
+
72
+ // Route & Endpoint Declarations
73
+ defineApi: require('../src/api/define-api').defineApi,
74
+ api: require('../src/api/define-api').defineApi,
75
+ definePage: require('../src/pages/define-page').definePage,
76
+ page: require('../src/pages/define-page').definePage,
77
+
78
+ // Lifecycle & Shutdown
79
+ ShutdownManager,
80
+
81
+ // In-Memory & Tagged Cache Engine
82
+ cache,
83
+ LruCache: cache.LruCache,
84
+ createLruCache: cache.createLruCache,
85
+ TaggedLruCache: cache.TaggedLruCache,
86
+ createTaggedLruCache: cache.createTaggedLruCache,
87
+ approximateByteSize: cache.approximateByteSize,
88
+ normalizeCacheConfig: cache.normalizeCacheConfig,
89
+ parseCacheTtlMs: cache.parseCacheTtlMs,
90
+ createOrmCacheProvider: cache.createOrmCacheProvider,
91
+
92
+ // Resilience & Fault Tolerance (Circuit Breaker & Retry Engine)
93
+ resilience,
94
+ CircuitBreaker: resilience.CircuitBreaker,
95
+ createCircuitBreaker: resilience.createCircuitBreaker,
96
+ STATE_CLOSED: resilience.STATE_CLOSED,
97
+ STATE_OPEN: resilience.STATE_OPEN,
98
+ STATE_HALF_OPEN: resilience.STATE_HALF_OPEN,
99
+ retry: resilience.retry,
100
+ withRetry: resilience.withRetry,
101
+ isTransientError: resilience.isTransientError,
102
+ calculateBackoffDelay: resilience.calculateBackoffDelay,
103
+ CircuitBreakerRegistry: resilience.CircuitBreakerRegistry,
104
+ circuitBreakerRegistry: resilience.circuitBreakerRegistry,
105
+ getBreaker: resilience.getBreaker,
106
+ CircuitBreakerOpenError: resilience.CircuitBreakerOpenError,
107
+ CircuitBreakerTimeoutError: resilience.CircuitBreakerTimeoutError,
108
+
109
+ // Decoupled Events & Signals
110
+ events: events.events,
111
+ EventDispatcher: events.EventDispatcher,
112
+ createEventDispatcher: events.createEventDispatcher,
113
+ Signal: events.Signal,
114
+ defineSignal: events.defineSignal,
115
+ defineListener: events.defineListener,
116
+ loadListeners: events.loadListeners,
117
+
118
+ // Cloud Secrets Management
119
+ secrets,
120
+ SecretManager: secrets.SecretManager,
121
+ createSecretManager: secrets.createSecretManager,
122
+ loadSecrets: secrets.loadSecrets,
123
+ resolveSecret: secrets.resolveSecret,
124
+ SecretNotFoundError: secrets.SecretNotFoundError,
125
+ GcpSecretProvider: secrets.GcpSecretProvider,
126
+ AwsSecretProvider: secrets.AwsSecretProvider,
127
+ EnvSecretProvider: secrets.EnvSecretProvider,
128
+ MemorySecretProvider: secrets.MemorySecretProvider,
129
+
130
+ // Cloud Metrics & Distributed Tracing
131
+ metrics,
132
+ MetricsRegistry: metrics.MetricsRegistry,
133
+ createMetricsRegistry: metrics.createMetricsRegistry,
134
+ setupMetricsMiddleware: metrics.setupMetricsMiddleware,
135
+ createMetricsManager: metrics.createMetricsManager,
136
+
137
+ // Exceptions & Errors
138
+ errors,
139
+ WebspressoError: errors.WebspressoError,
140
+ HttpError: errors.HttpError,
141
+ BadRequestError: errors.BadRequestError,
142
+ UnauthorizedError: errors.UnauthorizedError,
143
+ ForbiddenError: errors.ForbiddenError,
144
+ NotFoundError: errors.NotFoundError,
145
+ MethodNotAllowedError: errors.MethodNotAllowedError,
146
+ ConflictError: errors.ConflictError,
147
+ PayloadTooLargeError: errors.PayloadTooLargeError,
148
+ UnsupportedMediaTypeError: errors.UnsupportedMediaTypeError,
149
+ UnprocessableEntityError: errors.UnprocessableEntityError,
150
+ RequestTimeoutError: errors.RequestTimeoutError,
151
+ TooManyRequestsError: errors.TooManyRequestsError,
152
+ ServiceUnavailableError: errors.ServiceUnavailableError,
153
+ GatewayTimeoutError: errors.GatewayTimeoutError,
154
+ ValidationError: errors.ValidationError,
155
+ ConfigurationError: errors.ConfigurationError,
156
+ PluginError: errors.PluginError,
157
+ SecurityError: errors.SecurityError,
158
+ RequestError: errors.RequestError,
159
+ RequestAbortedError: errors.RequestAbortedError,
160
+ normalizeError: errors.normalizeError,
161
+ toErrorResponseObject: errors.toErrorResponseObject,
162
+
163
+ // Validation
164
+ z: require('./validation').z,
165
+
166
+ // Plugin System
167
+ PluginManager,
168
+ createPluginManager,
169
+ getPluginManager,
170
+ resetPluginManager,
171
+
172
+ // Core Utilities
173
+ fetchWithTimeout: require('./utils/fetch').fetchWithTimeout,
174
+ safeCompare: require('./utils/crypto').safeCompare,
175
+ sha256: require('./utils/crypto').sha256,
176
+ hmacSha256: require('./utils/crypto').hmacSha256,
177
+ randomToken: require('./utils/crypto').randomToken,
178
+ randomId: require('./utils/crypto').randomId,
179
+ base64UrlEncode: require('./utils/crypto').base64UrlEncode,
180
+ base64UrlDecode: require('./utils/crypto').base64UrlDecode,
181
+ escapeHtml: require('./utils/html').escapeHtml,
182
+ unescapeHtml: require('./utils/html').unescapeHtml,
183
+ walkDirectory: require('./utils/fs').walkDirectory,
184
+ walkDirectoryDetailed: require('./utils/fs').walkDirectoryDetailed,
185
+ stripTrailingSlash: require('./utils/url').stripTrailingSlash,
186
+ ensureLeadingSlash: require('./utils/url').ensureLeadingSlash,
187
+ ensureTrailingSlash: require('./utils/url').ensureTrailingSlash,
188
+ stripLeadingSlash: require('./utils/url').stripLeadingSlash,
189
+ joinUrl: require('./utils/url').joinUrl,
190
+ escapeRegExp: require('./utils/regex').escapeRegExp,
191
+ escapeRegex: require('./utils/regex').escapeRegExp,
192
+ globToRegExp: require('./utils/regex').globToRegExp,
193
+ parseDurationSec: require('./utils/time').parseDurationSec,
194
+ parseDuration: require('./utils/time').parseDurationSec,
195
+ parseDurationMs: require('./utils/time').parseDurationMs,
196
+ sleep: require('./utils/time').sleep,
197
+ safeJsonParse: require('./utils/json').safeJsonParse,
198
+ safeJsonStringify: require('./utils/json').safeJsonStringify,
199
+ isValidJson: require('./utils/json').isValidJson,
200
+ toSnakeCase: require('./utils/string').toSnakeCase,
201
+ snakeToCamel: require('./utils/string').snakeToCamel,
202
+ camelToSnake: require('./utils/string').camelToSnake,
203
+ toKebabCase: require('./utils/string').toKebabCase,
204
+ toPascalCase: require('./utils/string').toPascalCase,
205
+ ensureArray: require('./utils/object').ensureArray,
206
+ pick: require('./utils/object').pick,
207
+ omit: require('./utils/object').omit,
208
+ deepClone: require('./utils/object').deepClone,
209
+
210
+ // Timeouts
211
+ DEFAULT_TIMEOUTS: require('./utils/timeout').DEFAULT_TIMEOUTS,
212
+ normalizeTimeouts: require('./utils/timeout').normalizeTimeouts,
213
+ withTimeout: require('./utils/timeout').withTimeout,
214
+ TimeoutError: require('./utils/timeout').TimeoutError,
215
+
216
+ // Authorization & Policies
217
+ Bouncer: require('./auth/bouncer').Bouncer,
218
+ createBouncer: require('./auth/bouncer').createBouncer,
219
+ definePolicy: require('./auth/policy').definePolicy,
220
+ defineGate: require('./auth/policy').defineGate,
221
+ can: require('./auth/policy').can,
222
+ cannot: require('./auth/policy').cannot,
223
+ authorize: require('./auth/policy').authorize,
224
+
225
+ // Forms
226
+ normalizeErrors: require('./forms').normalizeErrors,
227
+ renderField: require('./forms').renderField,
228
+ renderFormFor: require('./forms').renderFormFor,
229
+ };
230
+
231
+ // Lazy getters for ORM, queue, mail, commands, and built-in service factories
232
+ Object.defineProperties(module.exports, {
233
+ // Built-in Services Creators
234
+ createAuthServices: { get: () => require('../src/services').createAuthServices, enumerable: true, configurable: true },
235
+ createMailServices: { get: () => require('../src/services').createMailServices, enumerable: true, configurable: true },
236
+ createMediaServices: { get: () => require('../src/services').createMediaServices, enumerable: true, configurable: true },
237
+ createFileManagerServices: { get: () => require('../src/services').createFileManagerServices, enumerable: true, configurable: true },
238
+ createSystemServices: { get: () => require('../src/services').createSystemServices, enumerable: true, configurable: true },
239
+ createExchangeServices: { get: () => require('../src/services').createExchangeServices, enumerable: true, configurable: true },
240
+
241
+ // ORM & Database Layer
242
+ orm: { get: () => getOrm(), enumerable: true, configurable: true },
243
+ createDatabase: { get: () => getOrm().createDatabase, enumerable: true, configurable: true },
244
+ createInMemoryDatabase: { get: () => getOrm().createInMemoryDatabase, enumerable: true, configurable: true },
245
+ defineModel: { get: () => getOrm().defineModel, enumerable: true, configurable: true },
246
+ zdb: { get: () => getOrm().zdb, enumerable: true, configurable: true },
247
+ BaseRepository: { get: () => getOrm().BaseRepository, enumerable: true, configurable: true },
248
+ Repository: { get: () => getOrm().Repository, enumerable: true, configurable: true },
249
+ createRepository: { get: () => getOrm().createRepository, enumerable: true, configurable: true },
250
+ getModel: { get: () => getOrm().getModel, enumerable: true, configurable: true },
251
+ getAllModels: { get: () => getOrm().getAllModels, enumerable: true, configurable: true },
252
+ hasModel: { get: () => getOrm().hasModel, enumerable: true, configurable: true },
253
+ clearRegistry: { get: () => getOrm().clearRegistry, enumerable: true, configurable: true },
254
+ runTransaction: { get: () => getOrm().runTransaction, enumerable: true, configurable: true },
255
+ runCloudMigration: { get: () => getOrm().runCloudMigration, enumerable: true, configurable: true },
256
+ waitForDatabaseConnection: { get: () => getOrm().waitForDatabaseConnection, enumerable: true, configurable: true },
257
+ freeStaleMigrationLock: { get: () => getOrm().freeStaleMigrationLock, enumerable: true, configurable: true },
258
+ getMigrationStatus: { get: () => getOrm().getMigrationStatus, enumerable: true, configurable: true },
259
+
260
+ // Background Jobs & Queue
261
+ queue: { get: () => require('./queue'), enumerable: true, configurable: true },
262
+ createQueueManager: { get: () => require('./queue').createQueueManager, enumerable: true, configurable: true },
263
+ QueueManager: { get: () => require('./queue').QueueManager, enumerable: true, configurable: true },
264
+ TaskScheduler: { get: () => require('./queue').TaskScheduler, enumerable: true, configurable: true },
265
+ CronExpression: { get: () => require('./queue').CronExpression, enumerable: true, configurable: true },
266
+ parseCron: { get: () => require('./queue').parseCron, enumerable: true, configurable: true },
267
+ isValidCron: { get: () => require('./queue').isValidCron, enumerable: true, configurable: true },
268
+ SqsQueueAdapter: { get: () => require('./queue').SqsQueueAdapter, enumerable: true, configurable: true },
269
+ PubSubQueueAdapter: { get: () => require('./queue').PubSubQueueAdapter, enumerable: true, configurable: true },
270
+
271
+ // Mail & Mailable
272
+ mail: { get: () => require('./mail'), enumerable: true, configurable: true },
273
+ Mailable: { get: () => require('./mail').Mailable, enumerable: true, configurable: true },
274
+ createMailer: { get: () => require('./mail').createMailer, enumerable: true, configurable: true },
275
+ Mailer: { get: () => require('./mail').Mailer, enumerable: true, configurable: true },
276
+ MemoryTransport: { get: () => require('./mail').MemoryTransport, enumerable: true, configurable: true },
277
+ ConsoleTransport: { get: () => require('./mail').ConsoleTransport, enumerable: true, configurable: true },
278
+ FileTransport: { get: () => require('./mail').FileTransport, enumerable: true, configurable: true },
279
+
280
+ // Commands & CLI
281
+ commands: { get: () => require('./commands'), enumerable: true, configurable: true },
282
+ defineCommand: { get: () => require('./commands').defineCommand, enumerable: true, configurable: true },
283
+ createCommandRegistry: { get: () => require('./commands').createCommandRegistry, enumerable: true, configurable: true },
284
+ executeCommand: { get: () => require('./commands').executeCommand, enumerable: true, configurable: true },
285
+
286
+ // Content
287
+ content: { get: () => require('./content'), enumerable: true, configurable: true },
288
+
289
+ // HTTP Adapter & Pipeline Layer
290
+ http: { get: () => require('./http'), enumerable: true, configurable: true },
291
+ HttpAdapter: { get: () => require('./http').HttpAdapter, enumerable: true, configurable: true },
292
+ ExpressHttpAdapter: { get: () => require('./http').ExpressHttpAdapter, enumerable: true, configurable: true },
293
+ createExpressHttpAdapter: { get: () => require('./http').createExpressHttpAdapter, enumerable: true, configurable: true },
294
+ HonoHttpAdapter: { get: () => require('./http').HonoHttpAdapter, enumerable: true, configurable: true },
295
+ createHonoHttpAdapter: { get: () => require('./http').createHonoHttpAdapter, enumerable: true, configurable: true },
296
+ executeApiPipeline: { get: () => require('./http').executeApiPipeline, enumerable: true, configurable: true },
297
+ executePagePipeline: { get: () => require('./http').executePagePipeline, enumerable: true, configurable: true },
298
+ runMiddlewares: { get: () => require('./http').runMiddlewares, enumerable: true, configurable: true },
299
+ enrichRouteError: { get: () => require('./http').enrichRouteError, enumerable: true, configurable: true },
300
+
301
+ // Authentication & Verification
302
+ auth: { get: () => require('./auth'), enumerable: true, configurable: true },
303
+ authenticateRequest: { get: () => require('./auth').authenticateRequest, enumerable: true, configurable: true },
304
+
305
+ // Structured Cloud Logging
306
+ logger: { get: () => require('./logger'), enumerable: true, configurable: true },
307
+ createLogger: { get: () => require('./logger').createLogger, enumerable: true, configurable: true },
308
+ createLogMiddleware: { get: () => require('./logger').createLogMiddleware, enumerable: true, configurable: true },
309
+ CloudLogger: { get: () => require('./logger').CloudLogger, enumerable: true, configurable: true },
310
+ extractTraceContext: { get: () => require('./logger').extractTraceContext, enumerable: true, configurable: true },
311
+
312
+ // Stateless Scale-Out & Distributed Sessions
313
+ createRedisSessionStore: { get: () => require('./auth').createRedisSessionStore, enumerable: true, configurable: true },
314
+ createRedisSessionTracker: { get: () => require('./auth').createRedisSessionTracker, enumerable: true, configurable: true },
315
+ RedisSessionStore: { get: () => require('./auth').RedisSessionStore, enumerable: true, configurable: true },
316
+ createMiniRedisClient: { get: () => require('./auth').createMiniRedisClient, enumerable: true, configurable: true },
317
+
318
+ // Serverless Database Connection Pool
319
+ normalizeServerlessPoolConfig: { get: () => require('./orm').normalizeServerlessPoolConfig, enumerable: true, configurable: true },
320
+ isServerlessEnvironment: { get: () => require('./orm').isServerlessEnvironment, enumerable: true, configurable: true },
321
+
322
+ // Zero-Dependency Rate Limiting
323
+ rateLimit: { get: () => require('./rate-limit').rateLimit, enumerable: true, configurable: true },
324
+ createRateLimiter: { get: () => require('./rate-limit').createRateLimiter, enumerable: true, configurable: true },
325
+ RateLimiter: { get: () => require('./rate-limit').RateLimiter, enumerable: true, configurable: true },
326
+ MemoryRateLimitStore: { get: () => require('./rate-limit').MemoryRateLimitStore, enumerable: true, configurable: true },
327
+ RedisRateLimitStore: { get: () => require('./rate-limit').RedisRateLimitStore, enumerable: true, configurable: true },
328
+
329
+ // Zero-Dependency Feature Flags & Canary Traffic Splitter
330
+ flags: { get: () => require('./flags'), enumerable: true, configurable: true },
331
+ FeatureFlagManager: { get: () => require('./flags').FeatureFlagManager, enumerable: true, configurable: true },
332
+ createFeatureFlagManager: { get: () => require('./flags').createFeatureFlagManager, enumerable: true, configurable: true },
333
+ MemoryFlagStore: { get: () => require('./flags').MemoryFlagStore, enumerable: true, configurable: true },
334
+ evaluateFlag: { get: () => require('./flags').evaluateFlag, enumerable: true, configurable: true },
335
+ getBucket: { get: () => require('./flags').getBucket, enumerable: true, configurable: true },
336
+ });
@@ -0,0 +1,34 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * Webspresso Payload Limits & DoS Protection Module
5
+ * Configurable body size limits for JSON, URL-encoded, raw, and text payloads,
6
+ * with route-level overrides, raw body capture, and seamless 413 PayloadTooLargeError handling.
7
+ *
8
+ * @module core/limits
9
+ */
10
+
11
+ const {
12
+ DEFAULT_LIMITS,
13
+ parseByteSize,
14
+ normalizeLimits,
15
+ } = require('./normalize');
16
+
17
+ const {
18
+ matchesPath,
19
+ shouldSkipBodyParser,
20
+ shouldCaptureRawBody,
21
+ createLimitsMiddleware,
22
+ setupLimitsMiddleware,
23
+ } = require('./middleware');
24
+
25
+ module.exports = {
26
+ DEFAULT_LIMITS,
27
+ parseByteSize,
28
+ normalizeLimits,
29
+ matchesPath,
30
+ shouldSkipBodyParser,
31
+ shouldCaptureRawBody,
32
+ createLimitsMiddleware,
33
+ setupLimitsMiddleware,
34
+ };
@@ -0,0 +1,325 @@
1
+ 'use strict';
2
+
3
+ /**
4
+ * Webspresso Payload Limits Middleware
5
+ * Zero-dependency body size enforcement, DoS protection, and raw body capture.
6
+ *
7
+ * @module core/limits/middleware
8
+ */
9
+
10
+ let _express = null;
11
+ function getExpress() {
12
+ if (!_express) {
13
+ _express = require('express');
14
+ }
15
+ return _express;
16
+ }
17
+ const { normalizeLimits } = require('./normalize');
18
+
19
+ /**
20
+ * Checks if a given URL pathname matches a path pattern (string, glob wildcard, or RegExp).
21
+ *
22
+ * @param {string|RegExp|Function} pattern
23
+ * @param {string} pathname
24
+ * @returns {boolean}
25
+ */
26
+ function matchesPath(pattern, pathname) {
27
+ if (!pathname || !pattern) return false;
28
+
29
+ if (typeof pattern === 'function') {
30
+ try {
31
+ return Boolean(pattern(pathname));
32
+ } catch {
33
+ return false;
34
+ }
35
+ }
36
+
37
+ if (pattern instanceof RegExp) {
38
+ return pattern.test(pathname);
39
+ }
40
+
41
+ if (typeof pattern !== 'string') return false;
42
+
43
+ // Exact match
44
+ if (pattern === pathname) return true;
45
+
46
+ // Wildcard match (e.g. /api/webhooks/* or /api/webhooks/**)
47
+ if (pattern.endsWith('/**')) {
48
+ const base = pattern.slice(0, -3);
49
+ return pathname === base || pathname.startsWith(base.endsWith('/') ? base : `${base}/`);
50
+ }
51
+ if (pattern.endsWith('/*')) {
52
+ const base = pattern.slice(0, -2);
53
+ return pathname === base || pathname.startsWith(base.endsWith('/') ? base : `${base}/`);
54
+ }
55
+
56
+ // Parameterized express pattern: /api/users/:id/upload
57
+ if (pattern.includes(':')) {
58
+ const regexPattern = '^' + pattern.replace(/\/:[^/]+/g, '/[^/]+') + '$';
59
+ try {
60
+ return new RegExp(regexPattern).test(pathname);
61
+ } catch {
62
+ return false;
63
+ }
64
+ }
65
+
66
+ return false;
67
+ }
68
+
69
+ /**
70
+ * Determines whether body parsing should be skipped for the incoming request.
71
+ *
72
+ * @param {import('express').Request} req
73
+ * @param {Array<string|RegExp|Function>} excludeList
74
+ * @returns {boolean}
75
+ */
76
+ function shouldSkipBodyParser(req, excludeList) {
77
+ if (!Array.isArray(excludeList) || excludeList.length === 0) {
78
+ return false;
79
+ }
80
+ const currentPath = req.path || '';
81
+ const originalUrl = req.originalUrl ? req.originalUrl.split('?')[0] : '';
82
+
83
+ return excludeList.some(
84
+ (pattern) => matchesPath(pattern, currentPath) || matchesPath(pattern, originalUrl)
85
+ );
86
+ }
87
+
88
+ /**
89
+ * Determines whether raw body buffer should be captured into `req.rawBody`.
90
+ *
91
+ * @param {import('express').Request} req
92
+ * @param {boolean|Array<string|RegExp>|Function} captureSetting
93
+ * @returns {boolean}
94
+ */
95
+ function shouldCaptureRawBody(req, captureSetting) {
96
+ if (!captureSetting) return false;
97
+ if (captureSetting === true) return true;
98
+
99
+ if (typeof captureSetting === 'function') {
100
+ try {
101
+ return Boolean(captureSetting(req));
102
+ } catch {
103
+ return false;
104
+ }
105
+ }
106
+
107
+ if (Array.isArray(captureSetting)) {
108
+ const currentPath = req.path || '';
109
+ const originalUrl = req.originalUrl ? req.originalUrl.split('?')[0] : '';
110
+ return captureSetting.some(
111
+ (pattern) => matchesPath(pattern, currentPath) || matchesPath(pattern, originalUrl)
112
+ );
113
+ }
114
+
115
+ return false;
116
+ }
117
+
118
+ /**
119
+ * Creates route-level limits middleware executing custom body parsers.
120
+ *
121
+ * @param {Object} [routeOptions]
122
+ * @returns {import('express').RequestHandler}
123
+ */
124
+ function createLimitsMiddleware(routeOptions = {}) {
125
+ const express = getExpress();
126
+ const limits = normalizeLimits(routeOptions);
127
+ const parsers = [];
128
+
129
+ function makeVerify(userVerify) {
130
+ return (req, res, buf, encoding) => {
131
+ if (typeof userVerify === 'function') {
132
+ userVerify(req, res, buf, encoding);
133
+ }
134
+ if (shouldCaptureRawBody(req, limits.captureRawBody)) {
135
+ req.rawBody = buf;
136
+ }
137
+ };
138
+ }
139
+
140
+ if (limits.json.enabled) {
141
+ parsers.push(
142
+ express.json({
143
+ ...limits.json.options,
144
+ limit: limits.json.limit,
145
+ strict: limits.json.strict,
146
+ verify: makeVerify(limits.json.verify),
147
+ })
148
+ );
149
+ }
150
+
151
+ if (limits.urlencoded.enabled) {
152
+ parsers.push(
153
+ express.urlencoded({
154
+ ...limits.urlencoded.options,
155
+ limit: limits.urlencoded.limit,
156
+ extended: limits.urlencoded.extended,
157
+ parameterLimit: limits.urlencoded.parameterLimit,
158
+ verify: makeVerify(limits.urlencoded.verify),
159
+ })
160
+ );
161
+ }
162
+
163
+ if (limits.raw.enabled) {
164
+ parsers.push(
165
+ express.raw({
166
+ ...limits.raw.options,
167
+ limit: limits.raw.limit,
168
+ type: limits.raw.type,
169
+ verify: makeVerify(limits.raw.verify),
170
+ })
171
+ );
172
+ }
173
+
174
+ if (limits.text.enabled) {
175
+ parsers.push(
176
+ express.text({
177
+ ...limits.text.options,
178
+ limit: limits.text.limit,
179
+ type: limits.text.type,
180
+ verify: makeVerify(limits.text.verify),
181
+ })
182
+ );
183
+ }
184
+
185
+ return function routeLimitsMiddleware(req, res, next) {
186
+ if (shouldSkipBodyParser(req, limits.exclude)) {
187
+ return next();
188
+ }
189
+
190
+ let idx = 0;
191
+ function runNextParser(err) {
192
+ if (err) return next(err);
193
+ if (idx >= parsers.length) return next();
194
+ const parser = parsers[idx++];
195
+ parser(req, res, runNextParser);
196
+ }
197
+
198
+ runNextParser();
199
+ };
200
+ }
201
+
202
+ /**
203
+ * Mounts payload limits and body parsing middleware onto an Express application.
204
+ *
205
+ * @param {import('express').Application} app
206
+ * @param {Object} [options]
207
+ * @returns {Object} Normalized limits configuration
208
+ */
209
+ function setupLimitsMiddleware(app, options = {}) {
210
+ const express = getExpress();
211
+ const limits = normalizeLimits(options);
212
+
213
+ // Expose limits on app instance for introspection
214
+ app.limits = limits;
215
+ if (typeof app.set === 'function') {
216
+ app.set('webspresso.limits', limits);
217
+ }
218
+
219
+ const allExcludes = [...limits.exclude];
220
+
221
+ // 1. Mount route-specific overrides (mounted first so they take precedence)
222
+ if (limits.routes && typeof limits.routes === 'object') {
223
+ for (const [routePattern, routeConfig] of Object.entries(limits.routes)) {
224
+ if (routeConfig === false) {
225
+ // Entirely exclude this route from global body parsing
226
+ allExcludes.push(routePattern);
227
+ } else if (routeConfig && typeof routeConfig === 'object') {
228
+ // Mount route-specific body parsers on the path
229
+ const routeMw = createLimitsMiddleware(routeConfig);
230
+ app.use(routePattern, routeMw);
231
+ }
232
+ }
233
+ }
234
+
235
+ // 2. Setup Global Body Parsers with exclusion checking and raw body capture
236
+ function globalVerify(userVerify) {
237
+ return (req, res, buf, encoding) => {
238
+ if (typeof userVerify === 'function') {
239
+ userVerify(req, res, buf, encoding);
240
+ }
241
+ if (shouldCaptureRawBody(req, limits.captureRawBody)) {
242
+ req.rawBody = buf;
243
+ }
244
+ };
245
+ }
246
+
247
+ // Global JSON Parser
248
+ if (limits.json.enabled) {
249
+ const jsonParserFn = express.json({
250
+ ...limits.json.options,
251
+ limit: limits.json.limit,
252
+ strict: limits.json.strict,
253
+ verify: globalVerify(limits.json.verify),
254
+ });
255
+
256
+ app.use(function jsonParser(req, res, next) {
257
+ if (req._body || shouldSkipBodyParser(req, allExcludes)) {
258
+ return next();
259
+ }
260
+ jsonParserFn(req, res, next);
261
+ });
262
+ }
263
+
264
+ // Global URL-Encoded Parser
265
+ if (limits.urlencoded.enabled) {
266
+ const urlencodedParserFn = express.urlencoded({
267
+ ...limits.urlencoded.options,
268
+ limit: limits.urlencoded.limit,
269
+ extended: limits.urlencoded.extended,
270
+ parameterLimit: limits.urlencoded.parameterLimit,
271
+ verify: globalVerify(limits.urlencoded.verify),
272
+ });
273
+
274
+ app.use(function urlencodedParser(req, res, next) {
275
+ if (req._body || shouldSkipBodyParser(req, allExcludes)) {
276
+ return next();
277
+ }
278
+ urlencodedParserFn(req, res, next);
279
+ });
280
+ }
281
+
282
+ // Global Raw Body Parser
283
+ if (limits.raw.enabled) {
284
+ const rawParser = express.raw({
285
+ ...limits.raw.options,
286
+ limit: limits.raw.limit,
287
+ type: limits.raw.type,
288
+ verify: globalVerify(limits.raw.verify),
289
+ });
290
+
291
+ app.use((req, res, next) => {
292
+ if (req._body || shouldSkipBodyParser(req, allExcludes)) {
293
+ return next();
294
+ }
295
+ rawParser(req, res, next);
296
+ });
297
+ }
298
+
299
+ // Global Text Parser
300
+ if (limits.text.enabled) {
301
+ const textParser = express.text({
302
+ ...limits.text.options,
303
+ limit: limits.text.limit,
304
+ type: limits.text.type,
305
+ verify: globalVerify(limits.text.verify),
306
+ });
307
+
308
+ app.use((req, res, next) => {
309
+ if (req._body || shouldSkipBodyParser(req, allExcludes)) {
310
+ return next();
311
+ }
312
+ textParser(req, res, next);
313
+ });
314
+ }
315
+
316
+ return limits;
317
+ }
318
+
319
+ module.exports = {
320
+ matchesPath,
321
+ shouldSkipBodyParser,
322
+ shouldCaptureRawBody,
323
+ createLimitsMiddleware,
324
+ setupLimitsMiddleware,
325
+ };