@guren/server 2.15.0 → 2.16.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 (296) hide show
  1. package/dist/{DocsViewerServiceProvider-qFCaeiUv.js → DocsViewerServiceProvider-D2cuVgtN.js} +7 -12
  2. package/dist/{Hash-C8aejmi8.js → Hash-D2DFd8xX.js} +7 -57
  3. package/dist/{HttpException-BkS3euNG.js → HttpException-BlQ2yEmT.js} +2 -79
  4. package/dist/{Job-BVT813DO.js → Job-DxQK8h3P.js} +24 -179
  5. package/dist/{McpServiceProvider-BawsYjgN.js → McpServiceProvider-nNcbCIQX.js} +11 -20
  6. package/dist/{Random-DbIJ22KQ.js → Random-S0OvCuR8.js} +9 -106
  7. package/dist/agent/AgentApprovalRequested.d.ts +11 -39
  8. package/dist/agent/approval.d.ts +76 -187
  9. package/dist/agent/audit-emitter.d.ts +16 -44
  10. package/dist/agent/audit.d.ts +20 -56
  11. package/dist/agent/derive.d.ts +32 -66
  12. package/dist/agent/dispatch.d.ts +38 -90
  13. package/dist/agent/events.d.ts +11 -19
  14. package/dist/agent/meta-tools.d.ts +18 -46
  15. package/dist/agent/public.d.ts +6 -25
  16. package/dist/agent/public.js +1 -1
  17. package/dist/agent/redact.d.ts +16 -38
  18. package/dist/agent/scopes.d.ts +23 -69
  19. package/dist/auth/AuthManager.d.ts +19 -40
  20. package/dist/auth/AuthenticatableModel.d.ts +2 -2
  21. package/dist/auth/SessionGuard.d.ts +0 -1
  22. package/dist/auth/TokenGuard.d.ts +6 -26
  23. package/dist/auth/api-token.d.ts +16 -148
  24. package/dist/auth/context.d.ts +5 -10
  25. package/dist/auth/email-verification.d.ts +29 -127
  26. package/dist/auth/index.js +1 -1
  27. package/dist/auth/oauth/index.d.ts +35 -57
  28. package/dist/auth/password/DefaultHasher.d.ts +5 -14
  29. package/dist/auth/password/PasswordHasher.d.ts +5 -13
  30. package/dist/auth/password/hash-format.d.ts +5 -13
  31. package/dist/auth/password-reset.d.ts +16 -42
  32. package/dist/auth/providers/ModelUserProvider.d.ts +3 -4
  33. package/dist/auth/providers/UserProvider.d.ts +4 -4
  34. package/dist/auth/signed-token.d.ts +18 -0
  35. package/dist/auth/types.d.ts +9 -32
  36. package/dist/auth/utils.d.ts +6 -27
  37. package/dist/{auth-DkYoAPVn.js → auth-CbdPH4Cd.js} +169 -502
  38. package/dist/authorization/Gate.d.ts +9 -145
  39. package/dist/authorization/Policy.d.ts +6 -53
  40. package/dist/authorization/index.js +1 -1
  41. package/dist/authorization/middleware.d.ts +16 -62
  42. package/dist/authorization/types.d.ts +8 -64
  43. package/dist/{authorization-CdfbCj8J.js → authorization-CdEWZZw3.js} +44 -309
  44. package/dist/broadcasting/BroadcastManager.d.ts +29 -149
  45. package/dist/broadcasting/channels/Channel.d.ts +1 -19
  46. package/dist/broadcasting/channels/PresenceChannel.d.ts +1 -55
  47. package/dist/broadcasting/channels/PrivateChannel.d.ts +1 -23
  48. package/dist/broadcasting/drivers/MemoryDriver.d.ts +18 -70
  49. package/dist/broadcasting/drivers/RedisDriver.d.ts +3 -80
  50. package/dist/broadcasting/drivers/index.d.ts +1 -1
  51. package/dist/broadcasting/index.d.ts +1 -1
  52. package/dist/broadcasting/index.js +1 -1
  53. package/dist/broadcasting/types.d.ts +7 -88
  54. package/dist/{broadcasting-BwodCA4q.js → broadcasting-B5RzB0A2.js} +87 -414
  55. package/dist/cache/CacheManager.d.ts +8 -62
  56. package/dist/cache/TaggedCache.d.ts +2 -35
  57. package/dist/cache/index.js +1 -1
  58. package/dist/cache/stores/FileStore.d.ts +2 -36
  59. package/dist/cache/stores/MemoryStore.d.ts +2 -26
  60. package/dist/cache/stores/RedisStore.d.ts +1 -29
  61. package/dist/cache/types.d.ts +21 -128
  62. package/dist/{cache-BYnZf2FR.js → cache-BOOIr324.js} +19 -198
  63. package/dist/client-C4TEr_Dd.js +9 -0
  64. package/dist/console/Command.d.ts +17 -126
  65. package/dist/console/ConsoleKernel.d.ts +2 -74
  66. package/dist/console/Input.d.ts +5 -113
  67. package/dist/console/Output.d.ts +3 -99
  68. package/dist/console/types.d.ts +3 -33
  69. package/dist/container/Container.d.ts +12 -103
  70. package/dist/container/ServiceProvider.d.ts +17 -61
  71. package/dist/container/bindings.d.ts +5 -26
  72. package/dist/container/defineModule.d.ts +16 -54
  73. package/dist/container/definePlugin.d.ts +12 -45
  74. package/dist/container/types.d.ts +2 -34
  75. package/dist/context-CXk_umpT.js +21 -0
  76. package/dist/database/Factory.d.ts +4 -57
  77. package/dist/database/Seeder.d.ts +8 -46
  78. package/dist/database/SeederRunner.d.ts +3 -33
  79. package/dist/database/types.d.ts +3 -24
  80. package/dist/discovery/AutoDiscovery.d.ts +10 -82
  81. package/dist/{dispatch-erOS9epZ.js → dispatch-BAwzftws.js} +32 -79
  82. package/dist/docs-viewer/DocsViewerServiceProvider.d.ts +2 -5
  83. package/dist/docs-viewer/endpoint.d.ts +5 -11
  84. package/dist/encryption/Encrypter.d.ts +5 -71
  85. package/dist/encryption/Hash.d.ts +7 -57
  86. package/dist/encryption/Random.d.ts +6 -99
  87. package/dist/encryption/index.js +3 -3
  88. package/dist/encryption/types.d.ts +10 -72
  89. package/dist/{encryption-D99Vmls3.js → encryption-uwP3Di4D.js} +9 -78
  90. package/dist/{endpoint-D6GIqOpe.js → endpoint-BXipU2Jj.js} +6 -12
  91. package/dist/endpoint-Dsw3Acvq.js +26 -0
  92. package/dist/errors/ExceptionHandler.d.ts +3 -90
  93. package/dist/errors/HttpException.d.ts +2 -79
  94. package/dist/errors/debug-page.d.ts +3 -17
  95. package/dist/errors/error-page.d.ts +1 -0
  96. package/dist/errors/exceptions/AuthenticationException.d.ts +2 -24
  97. package/dist/errors/exceptions/AuthorizationException.d.ts +1 -24
  98. package/dist/errors/exceptions/MethodNotAllowedException.d.ts +1 -23
  99. package/dist/errors/exceptions/NotFoundHttpException.d.ts +1 -27
  100. package/dist/errors/exceptions/ValidationException.d.ts +2 -43
  101. package/dist/errors/types.d.ts +1 -25
  102. package/dist/{errors-BgeOl_DC.js → errors-JpkcCjjn.js} +3 -41
  103. package/dist/events/Event.d.ts +1 -28
  104. package/dist/events/EventManager.d.ts +5 -107
  105. package/dist/events/Listener.d.ts +7 -55
  106. package/dist/events/builtin.d.ts +0 -24
  107. package/dist/events/index.js +1 -1
  108. package/dist/events/types.d.ts +4 -22
  109. package/dist/{events-aIH_bWRx.js → events-DOmAHDeP.js} +11 -191
  110. package/dist/facades/index.d.ts +2 -14
  111. package/dist/health/HealthCheck.d.ts +0 -24
  112. package/dist/health/HealthManager.d.ts +0 -36
  113. package/dist/health/checks/CacheCheck.d.ts +2 -17
  114. package/dist/health/checks/CustomCheck.d.ts +0 -9
  115. package/dist/health/checks/DatabaseCheck.d.ts +2 -17
  116. package/dist/health/checks/MemoryCheck.d.ts +3 -12
  117. package/dist/health/checks/RedisCheck.d.ts +1 -13
  118. package/dist/health/checks/StorageCheck.d.ts +2 -17
  119. package/dist/health/index.js +1 -1
  120. package/dist/health/types.d.ts +4 -24
  121. package/dist/{health-VWdWXRwh.js → health-DQSvUplL.js} +1 -76
  122. package/dist/hot-disposables-B5BXqaIH.js +167 -0
  123. package/dist/hot-reload/hot-disposables.d.ts +22 -74
  124. package/dist/hot-reload/testing.d.ts +4 -9
  125. package/dist/http/Application.d.ts +62 -208
  126. package/dist/http/FormRequest.d.ts +4 -55
  127. package/dist/http/dev-assets.d.ts +13 -31
  128. package/dist/http/dev-banner.d.ts +2 -5
  129. package/dist/http/inertia-assets.d.ts +3 -6
  130. package/dist/http/middleware/capabilities.d.ts +27 -50
  131. package/dist/http/middleware/cors.d.ts +4 -29
  132. package/dist/http/middleware/csp.d.ts +2 -25
  133. package/dist/http/middleware/csrf.d.ts +20 -95
  134. package/dist/http/middleware/detect-locale.d.ts +7 -27
  135. package/dist/http/middleware/force-https.d.ts +6 -24
  136. package/dist/http/middleware/host-authorization.d.ts +2 -12
  137. package/dist/http/middleware/loopback-guard.d.ts +15 -33
  138. package/dist/http/middleware/rate-limit.d.ts +29 -126
  139. package/dist/http/middleware/redirect-safety.d.ts +2 -20
  140. package/dist/http/middleware/request-id.d.ts +1 -14
  141. package/dist/http/middleware/request-logging.d.ts +2 -13
  142. package/dist/http/middleware/response-headers.d.ts +5 -13
  143. package/dist/http/middleware/security-headers.d.ts +2 -16
  144. package/dist/http/middleware/session.d.ts +15 -34
  145. package/dist/http/middleware/validation-errors-cookie.d.ts +7 -18
  146. package/dist/http/middleware/validation.d.ts +8 -63
  147. package/dist/http/public-assets.d.ts +11 -7
  148. package/dist/http/request.d.ts +32 -118
  149. package/dist/http/resources/CursorPaginator.d.ts +5 -64
  150. package/dist/http/resources/Paginator.d.ts +7 -84
  151. package/dist/http/resources/Resource.d.ts +9 -65
  152. package/dist/http/resources/ResourceCollection.d.ts +5 -39
  153. package/dist/http/resources/types.d.ts +10 -30
  154. package/dist/http/static-documents.d.ts +10 -20
  155. package/dist/http/validation/Validator.d.ts +25 -85
  156. package/dist/http/validation/rules.d.ts +48 -147
  157. package/dist/http/validation/types.d.ts +16 -61
  158. package/dist/http/vite-assets.d.ts +5 -28
  159. package/dist/http/vite-dev-server.d.ts +6 -9
  160. package/dist/http/vite-manifest.d.ts +19 -33
  161. package/dist/i18n/I18nManager.d.ts +12 -78
  162. package/dist/i18n/Translator.d.ts +3 -54
  163. package/dist/i18n/index.js +1 -1
  164. package/dist/i18n/loaders/JsonLoader.d.ts +4 -31
  165. package/dist/i18n/loaders/MemoryLoader.d.ts +1 -21
  166. package/dist/i18n/pluralization.d.ts +4 -13
  167. package/dist/i18n/types.d.ts +17 -69
  168. package/dist/{i18n-mcWi7LCd.js → i18n-Cg1aajRP.js} +31 -225
  169. package/dist/index.d.ts +2 -1
  170. package/dist/index.js +714 -3011
  171. package/dist/internal/agent-preflight.d.ts +9 -21
  172. package/dist/internal/request.d.ts +6 -19
  173. package/dist/internal/request.js +1 -1
  174. package/dist/internal/route-path.d.ts +9 -21
  175. package/dist/internal/route-path.js +9 -21
  176. package/dist/internal/zod-compat.d.ts +55 -122
  177. package/dist/internal/zod-compat.js +39 -70
  178. package/dist/internal/zod-json-schema.d.ts +18 -54
  179. package/dist/internal/zod-json-schema.js +46 -123
  180. package/dist/jsx-runtime.d.ts +3 -8
  181. package/dist/lambda/index.d.ts +17 -79
  182. package/dist/lambda/index.js +11 -59
  183. package/dist/logging/LogManager.d.ts +1 -51
  184. package/dist/logging/Logger.d.ts +8 -47
  185. package/dist/logging/channels/ConsoleChannel.d.ts +1 -3
  186. package/dist/logging/channels/DailyFileChannel.d.ts +1 -3
  187. package/dist/logging/channels/FileChannel.d.ts +1 -3
  188. package/dist/logging/daily-file-path.d.ts +7 -16
  189. package/dist/logging/index.js +1 -1
  190. package/dist/logging/types.d.ts +13 -45
  191. package/dist/{logging-B-kngi3q.js → logging-zOY1XCtq.js} +52 -141
  192. package/dist/{loopback-guard-D0Kc7-xc.js → loopback-guard-DT9gHF0F.js} +41 -92
  193. package/dist/mail/Mail.d.ts +10 -106
  194. package/dist/mail/MailManager.d.ts +2 -60
  195. package/dist/mail/index.js +1 -1
  196. package/dist/mail/transports/LogTransport.d.ts +1 -4
  197. package/dist/mail/transports/MemoryTransport.d.ts +1 -63
  198. package/dist/mail/transports/ResendTransport.d.ts +1 -23
  199. package/dist/mail/transports/SmtpTransport.d.ts +1 -31
  200. package/dist/mail/types.d.ts +28 -150
  201. package/dist/{mail-DfEfSQEr.js → mail-76DWy9lj.js} +31 -289
  202. package/dist/mcp/McpServiceProvider.d.ts +4 -10
  203. package/dist/mcp/create-mcp-server.d.ts +25 -57
  204. package/dist/mcp/endpoint.d.ts +12 -36
  205. package/dist/mcp/index.js +1 -1
  206. package/dist/mvc/Controller.d.ts +46 -227
  207. package/dist/mvc/Router.d.ts +50 -129
  208. package/dist/mvc/inertia/InertiaEngine.d.ts +18 -48
  209. package/dist/mvc/inertia/shared.d.ts +6 -19
  210. package/dist/mvc/mount-route.d.ts +2 -6
  211. package/dist/mvc/view.d.ts +1 -2
  212. package/dist/notifications/Notification.d.ts +8 -75
  213. package/dist/notifications/NotificationManager.d.ts +15 -88
  214. package/dist/notifications/channels/DatabaseChannel.d.ts +1 -41
  215. package/dist/notifications/channels/MailChannel.d.ts +2 -31
  216. package/dist/notifications/channels/MemoryChannel.d.ts +2 -62
  217. package/dist/notifications/channels/SlackChannel.d.ts +3 -48
  218. package/dist/notifications/index.js +1 -1
  219. package/dist/notifications/notifiable-type.d.ts +3 -6
  220. package/dist/notifications/registry.d.ts +8 -27
  221. package/dist/notifications/types.d.ts +16 -53
  222. package/dist/{notifications-BGqmUNZ8.js → notifications-okWFs9ly.js} +37 -335
  223. package/dist/providers/AuthServiceProvider.d.ts +1 -3
  224. package/dist/providers/AuthorizationServiceProvider.d.ts +2 -3
  225. package/dist/providers/BroadcastServiceProvider.d.ts +1 -3
  226. package/dist/providers/CacheServiceProvider.d.ts +1 -3
  227. package/dist/providers/EncryptionServiceProvider.d.ts +1 -3
  228. package/dist/providers/ErrorServiceProvider.d.ts +1 -4
  229. package/dist/providers/EventServiceProvider.d.ts +1 -3
  230. package/dist/providers/HealthServiceProvider.d.ts +1 -3
  231. package/dist/providers/I18nServiceProvider.d.ts +6 -10
  232. package/dist/providers/InertiaServiceProvider.d.ts +1 -4
  233. package/dist/providers/LogServiceProvider.d.ts +1 -3
  234. package/dist/providers/MailServiceProvider.d.ts +1 -3
  235. package/dist/providers/NotificationServiceProvider.d.ts +1 -3
  236. package/dist/providers/OAuthServiceProvider.d.ts +1 -3
  237. package/dist/providers/QueueServiceProvider.d.ts +1 -3
  238. package/dist/providers/SchedulingServiceProvider.d.ts +1 -3
  239. package/dist/providers/StorageServiceProvider.d.ts +1 -3
  240. package/dist/queue/FailedJobReporter.d.ts +1 -24
  241. package/dist/queue/Job.d.ts +12 -99
  242. package/dist/queue/QueueManager.d.ts +6 -57
  243. package/dist/queue/Worker.d.ts +4 -65
  244. package/dist/queue/drivers/MemoryDriver.d.ts +3 -44
  245. package/dist/queue/drivers/RedisDriver.d.ts +7 -65
  246. package/dist/queue/drivers/SqsDriver.d.ts +6 -57
  247. package/dist/queue/drivers/SyncDriver.d.ts +10 -13
  248. package/dist/queue/index.js +2 -2
  249. package/dist/queue/types.d.ts +10 -92
  250. package/dist/{queue-CXrRK85G.js → queue-CcXCjuJI.js} +32 -260
  251. package/dist/redis/RedisApiTokenStore.d.ts +4 -56
  252. package/dist/redis/RedisEmailVerificationStore.d.ts +4 -37
  253. package/dist/redis/RedisOAuthStateStore.d.ts +2 -10
  254. package/dist/redis/RedisPasswordResetStore.d.ts +4 -37
  255. package/dist/redis/RedisRateLimitStore.d.ts +16 -49
  256. package/dist/redis/RedisSessionStore.d.ts +3 -44
  257. package/dist/redis/client.d.ts +2 -32
  258. package/dist/redis/index.js +47 -232
  259. package/dist/redis/redis-values.d.ts +6 -12
  260. package/dist/redis/scan-keys.d.ts +1 -4
  261. package/dist/request-CLOYytGP.js +68 -0
  262. package/dist/runtime/index.d.ts +2 -0
  263. package/dist/runtime/index.js +50 -92
  264. package/dist/scheduling/CronParser.d.ts +0 -29
  265. package/dist/scheduling/Schedule.d.ts +1 -153
  266. package/dist/scheduling/ScheduledTask.d.ts +0 -31
  267. package/dist/scheduling/Scheduler.d.ts +0 -70
  268. package/dist/scheduling/index.js +1 -1
  269. package/dist/scheduling/types.d.ts +4 -65
  270. package/dist/{scheduling-CPiEdtQd.js → scheduling-C6tcOtUl.js} +2 -287
  271. package/dist/storage/StorageManager.d.ts +0 -48
  272. package/dist/storage/drivers/LocalDriver.d.ts +1 -25
  273. package/dist/storage/drivers/MemoryDriver.d.ts +5 -35
  274. package/dist/storage/drivers/S3Driver.d.ts +6 -36
  275. package/dist/storage/drivers/s3-acl.d.ts +5 -10
  276. package/dist/storage/index.js +1 -1
  277. package/dist/storage/types.d.ts +27 -265
  278. package/dist/{storage-TLD9t0Q2.js → storage-BB59f07j.js} +17 -157
  279. package/dist/support/contained-path.d.ts +10 -20
  280. package/dist/support/error-polyfill.d.ts +4 -6
  281. package/dist/support/expiry.d.ts +17 -33
  282. package/dist/support/expiry.js +17 -33
  283. package/dist/support/import-map.d.ts +3 -7
  284. package/dist/support/inertia-defaults.d.ts +5 -10
  285. package/dist/support/redirect-target.d.ts +4 -6
  286. package/dist/support/stack-frames.d.ts +11 -50
  287. package/dist/support/trim-slashes.d.ts +4 -7
  288. package/dist/support/warn-once.d.ts +2 -6
  289. package/dist/{trim-slashes-ZJ_VsY5s.js → trim-slashes-BLY9hKAa.js} +4 -7
  290. package/dist/{vite-manifest-w_RSOvQW.js → vite-manifest-CTQp-SOo.js} +34 -58
  291. package/package.json +2 -2
  292. package/dist/client-Dd7vLcqp.js +0 -27
  293. package/dist/context-DoD0c7J_.js +0 -26
  294. package/dist/endpoint-D-20PiHY.js +0 -46
  295. package/dist/hot-disposables-WsTX2ySN.js +0 -281
  296. package/dist/request-CVQwpu2J.js +0 -129
@@ -1,41 +1,12 @@
1
1
  /**
2
- * The one Zod → JSON Schema rule, shared by every surface that has to describe
3
- * an application's contracts to something outside the process: `@guren/openapi`
4
- * renders it as OpenAPI 3.1 schema objects (which *are* JSON Schema 2020-12),
5
- * and RFC 0016's agent tools advertise it as MCP input/output schemas.
6
- *
7
- * Internal by the rules in `contributing/api-stability.md`: reachable only
8
- * through a deep import under `internal/`, never re-exported from
9
- * `@guren/server`'s or `@guren/core`'s index. No stability guarantee — it
10
- * exists so two derivations of the same schema cannot disagree, not as a
11
- * public extension point. That is the whole reason it was promoted out of
12
- * `@guren/openapi`: a second walker is how an agent tool comes to advertise a
13
- * schema the documented API contradicts.
14
- *
15
- * It lives in `@guren/server` rather than `@guren/core` (where RFC 0016 §2
16
- * first placed it) for a build-order reason, not a layering one. Core's index
17
- * is `export * from '@guren/server'`, so core builds *after* server and a
18
- * server module cannot import a core one — the edge would close a cycle, and
19
- * server's declaration build (`tsc -p tsconfig.build.json`, `paths: {}`)
20
- * would look for a core `dist/` that does not exist yet. `deriveAgentTools`
21
- * lives in `@guren/server`, so the walker had to move down to the package
22
- * both it and the OpenAPI generator can see. `@guren/core/internal/*`
23
- * re-exports this module, which keeps that the specifier every consumer
24
- * outside this package writes.
25
- *
26
- * Every `_def` read goes through `zod-compat.ts`, including the check reads
27
- * this module added. Reaching into `_def` here would put zod-layout knowledge
28
- * in two places, which is exactly the split `zod-compat` exists to prevent.
29
- *
30
- * Zod 4 only, and a v3 node is *refused* rather than walked — on v3 `_def.type`
31
- * holds a nested schema where v4 keeps the type name, so every read below would
32
- * misfire and produce a confidently wrong document. The refusal is re-checked
33
- * at each recursion, because a v3 node can hide inside a v4 wrapper.
34
- *
35
- * What this module does not decide: what a caller does with the warnings, and
36
- * how the result is embedded (a `requestBody` content map, an MCP `inputSchema`).
37
- * Warnings are appended to a caller-owned array so a document generator can
38
- * surface them per request and a codegen step can fail on them.
2
+ * The one Zod → JSON Schema rule, so two derivations of the same schema cannot
3
+ * disagree: `@guren/openapi` renders it as OpenAPI 3.1 schema objects, RFC
4
+ * 0016's agent tools advertise it as MCP input/output schemas. Internal per
5
+ * `contributing/api-stability.md`. It sits in `@guren/server` for build order:
6
+ * core's index is `export * from '@guren/server'`, so a server module importing
7
+ * core would close a cycle; `@guren/core/internal/*` re-exports it. Every `_def`
8
+ * read goes through `zod-compat.ts`. Zod 4 only — a v3 node is refused at each
9
+ * recursion (one can hide inside a v4 wrapper). Warnings go to a caller-owned array.
39
10
  */
40
11
  import { type SchemaIo, type ZodSchemaLike } from './zod-compat.js';
41
12
  export type JsonSchemaPrimitiveType = 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object' | 'null';
@@ -70,32 +41,25 @@ export interface JsonSchemaObject {
70
41
  allOf?: JsonSchemaObject[];
71
42
  }
72
43
  /**
73
- * An object schema taken apart rather than rendered — the shape a caller needs
74
- * when the properties do not stay together in one schema object (OpenAPI
75
- * expands a `query` schema into one parameter per property, and RFC 0016 merges
76
- * `params` + `query` + `body` into a single tool input).
44
+ * An object schema taken apart rather than rendered, for callers whose
45
+ * properties do not stay together in one schema object: OpenAPI expands `query`
46
+ * into one parameter each, RFC 0016 merges params/query/body into one input.
77
47
  */
78
48
  export interface ObjectSchemaDetails {
79
49
  properties: Record<string, JsonSchemaObject>;
80
50
  required: Set<string>;
81
51
  }
82
52
  /**
83
- * Turn a Zod schema into a JSON Schema object, appending a line to `warnings`
84
- * for anything it cannot express. `label` names the schema in those warnings
85
- * (`"POST /posts body.title"`); `io` picks the side of coercing and piped
86
- * schemas to describe — `input` is what a caller sends, `output` what a parse
87
- * produces.
88
- *
89
- * Returns `undefined` when the node contributes nothing (a bare `z.undefined()`)
90
- * or could not be read; a caller treats that as "omit this property".
53
+ * Turn a Zod schema into a JSON Schema object, appending to `warnings` anything
54
+ * it cannot express. `label` names the schema there (`"POST /posts body.title"`);
55
+ * `io` picks the side of coercing and piped schemas to describe. `undefined`
56
+ * means the node contributes nothing, or could not be read — omit the property.
91
57
  */
92
58
  export declare function toJsonSchema(schema: unknown, warnings: string[], label: string, io: SchemaIo): JsonSchemaObject | undefined;
93
59
  /**
94
- * Take an object schema apart into its properties and the set of keys a caller
95
- * must supply, looking through any wrappers around it. Warns and returns
96
- * `undefined` when the schema is absent, not Zod, or not an object once
97
- * unwrapped — a caller that expands properties into something else (query
98
- * parameters, merged tool input) has nothing to expand otherwise.
60
+ * Take an object schema apart into its properties and the keys a caller must
61
+ * supply, looking through wrappers. Warns and returns `undefined` when the
62
+ * schema is absent, not Zod, or not an object once unwrapped.
99
63
  */
100
64
  export declare function readObjectSchema(schema: unknown, warnings: string[], label: string, io: SchemaIo): ObjectSchemaDetails | undefined;
101
65
  /** Whether this value looks like a Zod schema at all — the gate every walk opens with. */
@@ -1,62 +1,21 @@
1
1
  import { SINGLE_CHILD_WRAPPERS, ZOD3_UNSUPPORTED_MESSAGE, arrayElement, enumValues, getTypeName, innerSchema, isZod3Schema, literalValues, objectShape, pipeSides, recordValueType, schemaChecks, schemaFormat, typeOf, unwrapSingleChild } from "./zod-compat.js";
2
2
  //#region src/internal/zod-json-schema.ts
3
3
  /**
4
- * The one Zod → JSON Schema rule, shared by every surface that has to describe
5
- * an application's contracts to something outside the process: `@guren/openapi`
6
- * renders it as OpenAPI 3.1 schema objects (which *are* JSON Schema 2020-12),
7
- * and RFC 0016's agent tools advertise it as MCP input/output schemas.
8
- *
9
- * Internal by the rules in `contributing/api-stability.md`: reachable only
10
- * through a deep import under `internal/`, never re-exported from
11
- * `@guren/server`'s or `@guren/core`'s index. No stability guarantee — it
12
- * exists so two derivations of the same schema cannot disagree, not as a
13
- * public extension point. That is the whole reason it was promoted out of
14
- * `@guren/openapi`: a second walker is how an agent tool comes to advertise a
15
- * schema the documented API contradicts.
16
- *
17
- * It lives in `@guren/server` rather than `@guren/core` (where RFC 0016 §2
18
- * first placed it) for a build-order reason, not a layering one. Core's index
19
- * is `export * from '@guren/server'`, so core builds *after* server and a
20
- * server module cannot import a core one — the edge would close a cycle, and
21
- * server's declaration build (`tsc -p tsconfig.build.json`, `paths: {}`)
22
- * would look for a core `dist/` that does not exist yet. `deriveAgentTools`
23
- * lives in `@guren/server`, so the walker had to move down to the package
24
- * both it and the OpenAPI generator can see. `@guren/core/internal/*`
25
- * re-exports this module, which keeps that the specifier every consumer
26
- * outside this package writes.
27
- *
28
- * Every `_def` read goes through `zod-compat.ts`, including the check reads
29
- * this module added. Reaching into `_def` here would put zod-layout knowledge
30
- * in two places, which is exactly the split `zod-compat` exists to prevent.
31
- *
32
- * Zod 4 only, and a v3 node is *refused* rather than walked — on v3 `_def.type`
33
- * holds a nested schema where v4 keeps the type name, so every read below would
34
- * misfire and produce a confidently wrong document. The refusal is re-checked
35
- * at each recursion, because a v3 node can hide inside a v4 wrapper.
36
- *
37
- * What this module does not decide: what a caller does with the warnings, and
38
- * how the result is embedded (a `requestBody` content map, an MCP `inputSchema`).
39
- * Warnings are appended to a caller-owned array so a document generator can
40
- * surface them per request and a codegen step can fail on them.
4
+ * The one Zod → JSON Schema rule, so two derivations of the same schema cannot
5
+ * disagree: `@guren/openapi` renders it as OpenAPI 3.1 schema objects, RFC
6
+ * 0016's agent tools advertise it as MCP input/output schemas. Internal per
7
+ * `contributing/api-stability.md`. It sits in `@guren/server` for build order:
8
+ * core's index is `export * from '@guren/server'`, so a server module importing
9
+ * core would close a cycle; `@guren/core/internal/*` re-exports it. Every `_def`
10
+ * read goes through `zod-compat.ts`. Zod 4 only — a v3 node is refused at each
11
+ * recursion (one can hide inside a v4 wrapper). Warnings go to a caller-owned array.
41
12
  */
42
13
  /**
43
- * Zod's string formats mapped to the JSON Schema `format` names that mean the
44
- * same thing, matched against zod's own `z.toJSONSchema()` output so the two
45
- * cannot disagree about, say, whether `z.url()` is `"url"` or `"uri"`.
46
- *
47
- * The line is "registered by JSON Schema 2020-12", not "short". Zod carries
48
- * plenty of formats the spec has never registered (`cuid`, `nanoid`, `emoji`,
49
- * `ulid`, `jwt`, `base64`…), and emitting those verbatim advertises a
50
- * constraint no consumer can interpret — an agent reading `format: "cuid"`
51
- * learns nothing it can act on, while the `type: "string"` it already had stays
52
- * true. Unmapped formats are dropped, not warned about: the schema is still
53
- * correct, just less specific.
54
- *
55
- * `time` is the one registered format deliberately left out, and zod omits it
56
- * from its own output for the same reason: JSON Schema's `time` is an RFC 3339
57
- * `full-time`, which requires an offset, while `z.iso.time()` accepts a local
58
- * wall-clock time. Claiming the format would assert an offset the schema does
59
- * not require.
14
+ * Zod's string formats mapped to the JSON Schema names meaning the same thing,
15
+ * matched against zod's own `z.toJSONSchema()` output. Formats JSON Schema
16
+ * 2020-12 does not register (`cuid`, `nanoid`, `jwt`…) say nothing a consumer
17
+ * can act on, so they are dropped silently. `time` is left out as zod does: JSON
18
+ * Schema's is an RFC 3339 `full-time` requiring an offset; `z.iso.time()` accepts local wall-clock.
60
19
  */
61
20
  const JSON_SCHEMA_STRING_FORMATS = {
62
21
  email: "email",
@@ -70,18 +29,11 @@ const JSON_SCHEMA_STRING_FORMATS = {
70
29
  ipv6: "ipv6"
71
30
  };
72
31
  /**
73
- * The `number_format` values that describe an integer. JSON Schema says this
74
- * with a *type*, not a format, so these change `type: "number"` to
75
- * `type: "integer"` — a `z.int()` that documents as `number` advertises a
76
- * contract admitting `3.14`, which the route then rejects.
77
- *
78
- * `float32` / `float64` are the other half of the same zod vocabulary and stay
79
- * plain numbers. The bounds each of these formats implies (zod's own emitter
80
- * adds `minimum: -2147483648` for `int32`, and the safe-integer range for
81
- * `safeint`) are deliberately not emitted: they are the representation's
82
- * limits rather than the application's contract, and they bury the constraints
83
- * an author actually wrote. `int64` / `uint64` need no entry — they sit on
84
- * `bigint` nodes, which this walker already renders as `integer`.
32
+ * The `number_format` values describing an integer. JSON Schema says this with a
33
+ * *type*, so these turn `type: "number"` into `"integer"` — a `z.int()` documented
34
+ * as `number` admits `3.14`. The bounds these formats imply are not emitted: they
35
+ * are the representation's limits and bury the constraints an author wrote.
36
+ * `int64`/`uint64` need no entry; they sit on `bigint` nodes.
85
37
  */
86
38
  const INTEGER_NUMBER_FORMATS = /* @__PURE__ */ new Set([
87
39
  "safeint",
@@ -89,14 +41,11 @@ const INTEGER_NUMBER_FORMATS = /* @__PURE__ */ new Set([
89
41
  "uint32"
90
42
  ]);
91
43
  /**
92
- * The string formats whose zod-supplied regex is worth carrying as `pattern` —
93
- * the ones a user *wrote as a pattern* (`.regex()`) or as a prefix/suffix/
94
- * substring test, which zod stores only as a compiled regex.
95
- *
96
- * The registered formats above are excluded on purpose even though zod exposes
97
- * a pattern for them too: their regexes run to hundreds of characters (the
98
- * `datetime` one alone is ~300), they are zod's parsing implementation rather
99
- * than the contract, and `format` already says the same thing in a word.
44
+ * The string formats whose zod-supplied regex is worth carrying as `pattern`:
45
+ * the ones a user wrote as a pattern or a prefix/suffix/substring test, which
46
+ * zod stores only as a compiled regex. The registered formats above are
47
+ * excluded even though zod exposes patterns for them — those run to hundreds of
48
+ * characters and are its parser, while `format` says the same in a word.
100
49
  */
101
50
  const PATTERN_BEARING_FORMATS = /* @__PURE__ */ new Set([
102
51
  "regex",
@@ -105,14 +54,10 @@ const PATTERN_BEARING_FORMATS = /* @__PURE__ */ new Set([
105
54
  "includes"
106
55
  ]);
107
56
  /**
108
- * Turn a Zod schema into a JSON Schema object, appending a line to `warnings`
109
- * for anything it cannot express. `label` names the schema in those warnings
110
- * (`"POST /posts body.title"`); `io` picks the side of coercing and piped
111
- * schemas to describe — `input` is what a caller sends, `output` what a parse
112
- * produces.
113
- *
114
- * Returns `undefined` when the node contributes nothing (a bare `z.undefined()`)
115
- * or could not be read; a caller treats that as "omit this property".
57
+ * Turn a Zod schema into a JSON Schema object, appending to `warnings` anything
58
+ * it cannot express. `label` names the schema there (`"POST /posts body.title"`);
59
+ * `io` picks the side of coercing and piped schemas to describe. `undefined`
60
+ * means the node contributes nothing, or could not be read — omit the property.
116
61
  */
117
62
  function toJsonSchema(schema, warnings, label, io) {
118
63
  if (warnIfZod3(schema, warnings, label)) return;
@@ -212,11 +157,9 @@ function toJsonSchema(schema, warnings, label, io) {
212
157
  }
213
158
  }
214
159
  /**
215
- * Take an object schema apart into its properties and the set of keys a caller
216
- * must supply, looking through any wrappers around it. Warns and returns
217
- * `undefined` when the schema is absent, not Zod, or not an object once
218
- * unwrapped — a caller that expands properties into something else (query
219
- * parameters, merged tool input) has nothing to expand otherwise.
160
+ * Take an object schema apart into its properties and the keys a caller must
161
+ * supply, looking through wrappers. Warns and returns `undefined` when the
162
+ * schema is absent, not Zod, or not an object once unwrapped.
220
163
  */
221
164
  function readObjectSchema(schema, warnings, label, io) {
222
165
  if (!schema) return;
@@ -236,9 +179,8 @@ function isZodSchema(schema) {
236
179
  }
237
180
  /**
238
181
  * Push the v3 refusal warning and report whether it fired. One helper so the
239
- * composed message cannot drift between the entry points, and so the recursive
240
- * walks re-check nested nodes — a v3 schema can sit inside a v4 object, and an
241
- * ungated recursion would document it wrong instead of refusing it.
182
+ * message cannot drift between entry points, and so recursive walks re-check
183
+ * nested nodes — a v3 schema can sit inside a v4 object.
242
184
  */
243
185
  function warnIfZod3(schema, warnings, label) {
244
186
  if (schema && typeof schema === "object" && isZod3Schema(schema)) {
@@ -273,11 +215,8 @@ function readObjectSchemaDetails(schema, warnings, label, io) {
273
215
  }
274
216
  /**
275
217
  * Whether a caller may leave this property out — the `required` half of an
276
- * object schema.
277
- *
278
- * Stays here rather than joining `unwrapSingleChild` in `zod-compat`: applying
279
- * the wrapper vocabulary is schema-reading, but what to *conclude* from a
280
- * wrapper is a policy each caller sets — see the `pipe` case.
218
+ * object schema. Stays here rather than in `zod-compat`: what to *conclude*
219
+ * from a wrapper is a policy each caller sets, as the `pipe` case shows.
281
220
  */
282
221
  function isOptional(schema, io) {
283
222
  switch (typeOf(schema)) {
@@ -318,11 +257,9 @@ function literalSchema(def) {
318
257
  return {};
319
258
  }
320
259
  /**
321
- * A check value that JSON Schema can carry. The guard is not ceremonial: the
322
- * same `greater_than` / `min_length` check kinds are attached to `z.date()` and
323
- * `z.bigint()`, where the bound is a `Date` or a `bigint` — emitting either
324
- * would produce a keyword whose value is not a JSON number (and, for bigint,
325
- * one that `JSON.stringify` throws on).
260
+ * A check value JSON Schema can carry. The guard is not ceremonial: the same
261
+ * check kinds sit on `z.date()` and `z.bigint()`, whose bounds are not JSON
262
+ * numbers — and a bigint is one `JSON.stringify` throws on.
326
263
  */
327
264
  function numeric(value) {
328
265
  return typeof value === "number" && Number.isFinite(value) ? value : void 0;
@@ -365,17 +302,11 @@ function lengthConstraints(checks, minKey, maxKey) {
365
302
  return constraints;
366
303
  }
367
304
  /**
368
- * Every format this node declares, in the order a reader should prefer them.
369
- *
370
- * Two sources, because zod has two spellings: the top-level constructors
371
- * (`z.email()`, `z.int()`) record the format on the node, while the equivalent
372
- * methods (`z.string().email()`, `z.number().int()`) attach it as a check and
373
- * leave the node's own field empty. Reading one source loses half the formats
374
- * an app writes, so both are collected here once rather than in each caller.
375
- *
376
- * Takes the node's checks rather than re-reading them: every caller has already
377
- * walked `_def.checks` for something else, and this walker is on RFC 0016's
378
- * tool-derivation path as well as the document one.
305
+ * Every format this node declares, in preference order. Two sources, because
306
+ * zod has two spellings: the top-level constructors record the format on the
307
+ * node, the equivalent methods attach it as a check — reading one loses half
308
+ * the formats an app writes. Takes the checks rather than re-reading them,
309
+ * since every caller has already walked `_def.checks` for something else.
379
310
  */
380
311
  function declaredFormats(schema, checks) {
381
312
  const onNode = schemaFormat(schema);
@@ -409,18 +340,10 @@ function stringConstraints(schema) {
409
340
  }
410
341
  /**
411
342
  * Put the first value under `keyword` and fold any remainder into `allOf`.
412
- *
413
- * JSON Schema allows one `pattern` and one `multipleOf` per schema object, so a
414
- * node carrying two of either (`z.string().regex(/^a/).startsWith('b')`,
415
- * `z.number().multipleOf(2).multipleOf(3)`) cannot state both in place. Keeping
416
- * only the first is not a lesser answer, it is a wrong one: the emitted schema
417
- * then *accepts values the route rejects*, which is the one direction a derived
418
- * contract must never be wrong in — an agent handed it will send input that
419
- * fails validation. `allOf` conjoins, so the surplus stays enforceable.
420
- *
421
- * The first value stays on the node rather than going into `allOf` with the
422
- * rest, so the overwhelmingly common single-constraint case emits flat.
423
- * (zod's own emitter drops the surplus `multipleOf` outright here.)
343
+ * JSON Schema allows one `pattern` and one `multipleOf` per schema object, and
344
+ * keeping only the first would emit a schema *accepting values the route rejects*
345
+ * — the one direction a derived contract must never be wrong in. `allOf` conjoins,
346
+ * so the surplus stays enforceable (zod's own emitter drops it); one constraint still emits flat.
424
347
  */
425
348
  function assignWithSurplus(constraints, keyword, values) {
426
349
  const [first, ...surplus] = values;
@@ -1,12 +1,7 @@
1
1
  /**
2
2
  * The app-facing JSX runtime for server-rendered content views (RFC 0014).
3
- *
4
- * Application View files opt in with a per-file `@jsxImportSource` pragma
5
- * pointing at `@guren/core`, which the compiler resolves to
6
- * `@guren/core/jsx-runtime` → here → hono. Routing the pragma through the
7
- * framework rather than at `hono/jsx` directly means applications never
8
- * declare hono themselves, and the runtime that compiles their JSX is the
9
- * same hono copy `Controller.view()` renders with — by construction, not by
10
- * install-layout luck.
3
+ * View files point their `@jsxImportSource` pragma at `@guren/core`, which
4
+ * resolves here and then to hono: apps never declare hono themselves, and their
5
+ * JSX compiles against the same hono copy `Controller.view()` renders with.
11
6
  */
12
7
  export * from 'hono/jsx/jsx-runtime';
@@ -2,9 +2,7 @@ import type { Application } from '../http/Application.js';
2
2
  import type { Scheduler } from '../scheduling/Scheduler.js';
3
3
  import type { ConsoleKernel } from '../console/ConsoleKernel.js';
4
4
  export type { APIGatewayProxyResult, LambdaEvent } from 'hono/aws-lambda';
5
- /**
6
- * SQS event record from AWS Lambda.
7
- */
5
+ /** SQS event record from AWS Lambda. */
8
6
  export interface SqsRecord {
9
7
  messageId: string;
10
8
  receiptHandle: string;
@@ -16,36 +14,19 @@ export interface SqsRecord {
16
14
  eventSourceARN: string;
17
15
  awsRegion: string;
18
16
  }
19
- /**
20
- * SQS event payload from AWS Lambda.
21
- */
17
+ /** SQS event payload from AWS Lambda. */
22
18
  export interface SqsEvent {
23
19
  Records: SqsRecord[];
24
20
  }
25
- /**
26
- * SQS batch item failure for partial batch response.
27
- */
21
+ /** SQS batch item failure for partial batch response. */
28
22
  export interface SqsBatchItemFailure {
29
23
  itemIdentifier: string;
30
24
  }
31
- /**
32
- * SQS batch response with partial failures.
33
- */
25
+ /** SQS batch response with partial failures. */
34
26
  export interface SqsBatchResponse {
35
27
  batchItemFailures: SqsBatchItemFailure[];
36
28
  }
37
- /**
38
- * Create an AWS Lambda handler from a booted Guren application.
39
- *
40
- * @example
41
- * ```typescript
42
- * import app from './src/app'
43
- * import { createLambdaHandler } from '@guren/server/lambda'
44
- *
45
- * await app.boot()
46
- * export const handler = createLambdaHandler(app)
47
- * ```
48
- */
29
+ /** Create an AWS Lambda handler from an already booted Guren application. */
49
30
  export declare function createLambdaHandler(app: Application): <L extends import("hono/aws-lambda").LambdaEvent>(event: L, lambdaContext?: import("hono/aws-lambda").LambdaContext) => Promise<import("hono/aws-lambda").APIGatewayProxyResult & (L extends {
50
31
  multiValueHeaders: Record<string, string[]>;
51
32
  } ? {
@@ -56,77 +37,34 @@ export declare function createLambdaHandler(app: Application): <L extends import
56
37
  multiValueHeaders?: undefined;
57
38
  })>;
58
39
  /**
59
- * Create an AWS Lambda handler for processing SQS queue jobs.
60
- *
61
- * Supports partial batch failure reporting — only failed messages
62
- * are returned to SQS for retry, while successful ones are deleted.
63
- *
64
- * @example
65
- * ```typescript
66
- * import app from './src/app'
67
- * import { createSqsHandler } from '@guren/server/lambda'
68
- *
69
- * await app.boot()
70
- * export const queue = createSqsHandler()
71
- * ```
40
+ * Create an AWS Lambda handler for SQS queue jobs. Reports partial batch
41
+ * failures, so only failed messages go back to SQS for retry.
72
42
  */
73
43
  export declare function createSqsHandler(): (event: SqsEvent) => Promise<SqsBatchResponse>;
74
- /**
75
- * Create an AWS Lambda handler for running scheduled tasks via EventBridge.
76
- *
77
- * @example
78
- * ```typescript
79
- * import { createScheduleHandler } from '@guren/server/lambda'
80
- * import { scheduler } from './src/scheduler'
81
- *
82
- * export const schedule = createScheduleHandler(scheduler)
83
- * ```
84
- */
44
+ /** Create an AWS Lambda handler for running scheduled tasks via EventBridge. */
85
45
  export declare function createScheduleHandler(scheduler: Scheduler): () => Promise<void>;
86
- /**
87
- * Console command event payload for Lambda.
88
- */
46
+ /** Console command event payload for Lambda. */
89
47
  export interface ConsoleEvent {
90
- /**
91
- * Command string to execute (e.g. "db:migrate", "users:create john@example.com --admin").
92
- */
48
+ /** Command string to execute, e.g. `"users:create jo@example.com --admin"`. */
93
49
  command: string;
94
50
  }
95
- /**
96
- * Console command result from Lambda.
97
- */
51
+ /** Console command result from Lambda. */
98
52
  export interface ConsoleResult {
99
53
  exitCode: number;
100
54
  }
101
55
  /**
102
- * Create an AWS Lambda handler for running console commands.
103
- *
104
- * Invoke via AWS CLI, SDK, or EventBridge with a JSON payload:
105
- * `{ "command": "db:migrate" }`
106
- *
107
- * @example
108
- * ```typescript
109
- * import { createConsoleHandler } from '@guren/server/lambda'
110
- * import { kernel } from './src/console'
111
- *
112
- * export const console = createConsoleHandler(kernel)
113
- * ```
56
+ * Create an AWS Lambda handler for running console commands. Invoke via AWS
57
+ * CLI, SDK, or EventBridge with a payload like `{ "command": "db:migrate" }`.
114
58
  */
115
59
  export declare function createConsoleHandler(kernel: ConsoleKernel): (event: ConsoleEvent) => Promise<ConsoleResult>;
116
60
  /**
117
- * Detect if the current process is running inside AWS Lambda.
118
- *
119
- * Checks for the `AWS_LAMBDA_FUNCTION_NAME` environment variable,
120
- * which AWS sets automatically in all Lambda runtimes.
61
+ * Whether the process is running inside AWS Lambda, by the
62
+ * `AWS_LAMBDA_FUNCTION_NAME` variable AWS sets in every Lambda runtime.
121
63
  */
122
64
  export declare function isLambda(): boolean;
123
- /**
124
- * Get Lambda environment metadata, or null if not running on Lambda.
125
- */
65
+ /** Get Lambda environment metadata, or null if not running on Lambda. */
126
66
  export declare function getLambdaContext(): LambdaRuntimeContext | null;
127
- /**
128
- * Lambda runtime context metadata.
129
- */
67
+ /** Lambda runtime context metadata. */
130
68
  export interface LambdaRuntimeContext {
131
69
  functionName: string;
132
70
  functionVersion: string;
@@ -1,35 +1,13 @@
1
- import { r as getJob } from "../Job-BVT813DO.js";
1
+ import { r as getJob } from "../Job-DxQK8h3P.js";
2
2
  import { handle } from "hono/aws-lambda";
3
3
  //#region src/lambda/index.ts
4
- /**
5
- * Create an AWS Lambda handler from a booted Guren application.
6
- *
7
- * @example
8
- * ```typescript
9
- * import app from './src/app'
10
- * import { createLambdaHandler } from '@guren/server/lambda'
11
- *
12
- * await app.boot()
13
- * export const handler = createLambdaHandler(app)
14
- * ```
15
- */
4
+ /** Create an AWS Lambda handler from an already booted Guren application. */
16
5
  function createLambdaHandler(app) {
17
6
  return handle(app.hono);
18
7
  }
19
8
  /**
20
- * Create an AWS Lambda handler for processing SQS queue jobs.
21
- *
22
- * Supports partial batch failure reporting — only failed messages
23
- * are returned to SQS for retry, while successful ones are deleted.
24
- *
25
- * @example
26
- * ```typescript
27
- * import app from './src/app'
28
- * import { createSqsHandler } from '@guren/server/lambda'
29
- *
30
- * await app.boot()
31
- * export const queue = createSqsHandler()
32
- * ```
9
+ * Create an AWS Lambda handler for SQS queue jobs. Reports partial batch
10
+ * failures, so only failed messages go back to SQS for retry.
33
11
  */
34
12
  function createSqsHandler() {
35
13
  return async (event) => {
@@ -53,35 +31,15 @@ function createSqsHandler() {
53
31
  return { batchItemFailures: failures };
54
32
  };
55
33
  }
56
- /**
57
- * Create an AWS Lambda handler for running scheduled tasks via EventBridge.
58
- *
59
- * @example
60
- * ```typescript
61
- * import { createScheduleHandler } from '@guren/server/lambda'
62
- * import { scheduler } from './src/scheduler'
63
- *
64
- * export const schedule = createScheduleHandler(scheduler)
65
- * ```
66
- */
34
+ /** Create an AWS Lambda handler for running scheduled tasks via EventBridge. */
67
35
  function createScheduleHandler(scheduler) {
68
36
  return async () => {
69
37
  await scheduler.runDueTasks();
70
38
  };
71
39
  }
72
40
  /**
73
- * Create an AWS Lambda handler for running console commands.
74
- *
75
- * Invoke via AWS CLI, SDK, or EventBridge with a JSON payload:
76
- * `{ "command": "db:migrate" }`
77
- *
78
- * @example
79
- * ```typescript
80
- * import { createConsoleHandler } from '@guren/server/lambda'
81
- * import { kernel } from './src/console'
82
- *
83
- * export const console = createConsoleHandler(kernel)
84
- * ```
41
+ * Create an AWS Lambda handler for running console commands. Invoke via AWS
42
+ * CLI, SDK, or EventBridge with a payload like `{ "command": "db:migrate" }`.
85
43
  */
86
44
  function createConsoleHandler(kernel) {
87
45
  return async (event) => {
@@ -90,17 +48,13 @@ function createConsoleHandler(kernel) {
90
48
  };
91
49
  }
92
50
  /**
93
- * Detect if the current process is running inside AWS Lambda.
94
- *
95
- * Checks for the `AWS_LAMBDA_FUNCTION_NAME` environment variable,
96
- * which AWS sets automatically in all Lambda runtimes.
51
+ * Whether the process is running inside AWS Lambda, by the
52
+ * `AWS_LAMBDA_FUNCTION_NAME` variable AWS sets in every Lambda runtime.
97
53
  */
98
54
  function isLambda() {
99
55
  return typeof process !== "undefined" && !!process.env?.AWS_LAMBDA_FUNCTION_NAME;
100
56
  }
101
- /**
102
- * Get Lambda environment metadata, or null if not running on Lambda.
103
- */
57
+ /** Get Lambda environment metadata, or null if not running on Lambda. */
104
58
  function getLambdaContext() {
105
59
  if (!isLambda()) return null;
106
60
  return {
@@ -113,9 +67,7 @@ function getLambdaContext() {
113
67
  tmpDir: "/tmp"
114
68
  };
115
69
  }
116
- /**
117
- * Deserialize a JSON SQS message body into a QueuedJob-like object.
118
- */
70
+ /** Deserialize a JSON SQS message body into a QueuedJob-like object. */
119
71
  function deserializeSqsJob(body) {
120
72
  const raw = JSON.parse(body);
121
73
  return {