@guren/server 2.15.0 → 2.17.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 (302) 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-Zihx3Bjq.js} +35 -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-status.d.ts +56 -0
  9. package/dist/agent/approval.d.ts +76 -187
  10. package/dist/agent/audit-emitter.d.ts +16 -44
  11. package/dist/agent/audit.d.ts +20 -56
  12. package/dist/agent/derive.d.ts +32 -66
  13. package/dist/agent/dispatch.d.ts +38 -90
  14. package/dist/agent/events.d.ts +17 -23
  15. package/dist/agent/gate.d.ts +118 -0
  16. package/dist/agent/meta-tools.d.ts +18 -46
  17. package/dist/agent/pipeline.d.ts +234 -0
  18. package/dist/agent/public.d.ts +6 -25
  19. package/dist/agent/public.js +1 -1
  20. package/dist/agent/redact.d.ts +16 -38
  21. package/dist/agent/scopes.d.ts +55 -69
  22. package/dist/auth/AgentPrincipalGuard.d.ts +49 -0
  23. package/dist/auth/AuthManager.d.ts +22 -43
  24. package/dist/auth/AuthenticatableModel.d.ts +2 -2
  25. package/dist/auth/SessionGuard.d.ts +0 -1
  26. package/dist/auth/TokenGuard.d.ts +6 -26
  27. package/dist/auth/api-token.d.ts +16 -148
  28. package/dist/auth/context.d.ts +5 -10
  29. package/dist/auth/email-verification.d.ts +29 -127
  30. package/dist/auth/index.js +1 -1
  31. package/dist/auth/oauth/index.d.ts +35 -57
  32. package/dist/auth/password/DefaultHasher.d.ts +5 -14
  33. package/dist/auth/password/PasswordHasher.d.ts +5 -13
  34. package/dist/auth/password/hash-format.d.ts +5 -13
  35. package/dist/auth/password-reset.d.ts +16 -42
  36. package/dist/auth/providers/ModelUserProvider.d.ts +3 -4
  37. package/dist/auth/providers/UserProvider.d.ts +4 -4
  38. package/dist/auth/signed-token.d.ts +18 -0
  39. package/dist/auth/types.d.ts +9 -32
  40. package/dist/auth/utils.d.ts +6 -27
  41. package/dist/{auth-DkYoAPVn.js → auth-Gg54ppQi.js} +279 -519
  42. package/dist/authorization/Gate.d.ts +9 -145
  43. package/dist/authorization/Policy.d.ts +6 -53
  44. package/dist/authorization/index.js +1 -1
  45. package/dist/authorization/middleware.d.ts +16 -62
  46. package/dist/authorization/types.d.ts +8 -64
  47. package/dist/{authorization-CdfbCj8J.js → authorization-CdEWZZw3.js} +44 -309
  48. package/dist/broadcasting/BroadcastManager.d.ts +29 -149
  49. package/dist/broadcasting/channels/Channel.d.ts +1 -19
  50. package/dist/broadcasting/channels/PresenceChannel.d.ts +1 -55
  51. package/dist/broadcasting/channels/PrivateChannel.d.ts +1 -23
  52. package/dist/broadcasting/drivers/MemoryDriver.d.ts +18 -70
  53. package/dist/broadcasting/drivers/RedisDriver.d.ts +3 -80
  54. package/dist/broadcasting/drivers/index.d.ts +1 -1
  55. package/dist/broadcasting/index.d.ts +1 -1
  56. package/dist/broadcasting/index.js +1 -1
  57. package/dist/broadcasting/types.d.ts +7 -88
  58. package/dist/{broadcasting-BwodCA4q.js → broadcasting-B5RzB0A2.js} +87 -414
  59. package/dist/cache/CacheManager.d.ts +8 -62
  60. package/dist/cache/TaggedCache.d.ts +2 -35
  61. package/dist/cache/index.js +1 -1
  62. package/dist/cache/stores/FileStore.d.ts +2 -36
  63. package/dist/cache/stores/MemoryStore.d.ts +2 -26
  64. package/dist/cache/stores/RedisStore.d.ts +1 -29
  65. package/dist/cache/types.d.ts +21 -128
  66. package/dist/{cache-BYnZf2FR.js → cache-BOOIr324.js} +19 -198
  67. package/dist/client-C4TEr_Dd.js +9 -0
  68. package/dist/console/Command.d.ts +17 -126
  69. package/dist/console/ConsoleKernel.d.ts +2 -74
  70. package/dist/console/Input.d.ts +5 -113
  71. package/dist/console/Output.d.ts +3 -99
  72. package/dist/console/types.d.ts +3 -33
  73. package/dist/container/Container.d.ts +12 -103
  74. package/dist/container/ServiceProvider.d.ts +17 -61
  75. package/dist/container/bindings.d.ts +5 -26
  76. package/dist/container/defineModule.d.ts +16 -54
  77. package/dist/container/definePlugin.d.ts +12 -45
  78. package/dist/container/types.d.ts +2 -34
  79. package/dist/context-CXk_umpT.js +21 -0
  80. package/dist/database/Factory.d.ts +4 -57
  81. package/dist/database/Seeder.d.ts +8 -46
  82. package/dist/database/SeederRunner.d.ts +3 -33
  83. package/dist/database/types.d.ts +3 -24
  84. package/dist/discovery/AutoDiscovery.d.ts +10 -82
  85. package/dist/{dispatch-erOS9epZ.js → dispatch-BAwzftws.js} +32 -79
  86. package/dist/docs-viewer/DocsViewerServiceProvider.d.ts +2 -5
  87. package/dist/docs-viewer/endpoint.d.ts +5 -11
  88. package/dist/encryption/Encrypter.d.ts +5 -71
  89. package/dist/encryption/Hash.d.ts +7 -57
  90. package/dist/encryption/Random.d.ts +6 -99
  91. package/dist/encryption/index.js +3 -3
  92. package/dist/encryption/types.d.ts +10 -72
  93. package/dist/{encryption-D99Vmls3.js → encryption-uwP3Di4D.js} +9 -78
  94. package/dist/{endpoint-D6GIqOpe.js → endpoint-BXipU2Jj.js} +6 -12
  95. package/dist/endpoint-Dsw3Acvq.js +26 -0
  96. package/dist/errors/ExceptionHandler.d.ts +3 -90
  97. package/dist/errors/HttpException.d.ts +2 -79
  98. package/dist/errors/debug-page.d.ts +3 -17
  99. package/dist/errors/error-page.d.ts +1 -0
  100. package/dist/errors/exceptions/AuthenticationException.d.ts +2 -24
  101. package/dist/errors/exceptions/AuthorizationException.d.ts +1 -24
  102. package/dist/errors/exceptions/MethodNotAllowedException.d.ts +1 -23
  103. package/dist/errors/exceptions/NotFoundHttpException.d.ts +1 -27
  104. package/dist/errors/exceptions/ValidationException.d.ts +2 -43
  105. package/dist/errors/types.d.ts +1 -25
  106. package/dist/{errors-BgeOl_DC.js → errors-JpkcCjjn.js} +3 -41
  107. package/dist/events/Event.d.ts +1 -28
  108. package/dist/events/EventManager.d.ts +5 -107
  109. package/dist/events/Listener.d.ts +7 -55
  110. package/dist/events/builtin.d.ts +0 -24
  111. package/dist/events/index.js +1 -1
  112. package/dist/events/types.d.ts +4 -22
  113. package/dist/{events-aIH_bWRx.js → events-DOmAHDeP.js} +11 -191
  114. package/dist/facades/index.d.ts +2 -14
  115. package/dist/health/HealthCheck.d.ts +0 -24
  116. package/dist/health/HealthManager.d.ts +0 -36
  117. package/dist/health/checks/CacheCheck.d.ts +2 -17
  118. package/dist/health/checks/CustomCheck.d.ts +0 -9
  119. package/dist/health/checks/DatabaseCheck.d.ts +2 -17
  120. package/dist/health/checks/MemoryCheck.d.ts +3 -12
  121. package/dist/health/checks/RedisCheck.d.ts +1 -13
  122. package/dist/health/checks/StorageCheck.d.ts +2 -17
  123. package/dist/health/index.js +1 -1
  124. package/dist/health/types.d.ts +4 -24
  125. package/dist/{health-VWdWXRwh.js → health-DQSvUplL.js} +1 -76
  126. package/dist/hot-disposables-B5BXqaIH.js +167 -0
  127. package/dist/hot-reload/hot-disposables.d.ts +22 -74
  128. package/dist/hot-reload/testing.d.ts +4 -9
  129. package/dist/http/Application.d.ts +77 -205
  130. package/dist/http/FormRequest.d.ts +4 -55
  131. package/dist/http/dev-assets.d.ts +13 -31
  132. package/dist/http/dev-banner.d.ts +2 -5
  133. package/dist/http/inertia-assets.d.ts +3 -6
  134. package/dist/http/middleware/capabilities.d.ts +27 -50
  135. package/dist/http/middleware/cors.d.ts +4 -29
  136. package/dist/http/middleware/csp.d.ts +2 -25
  137. package/dist/http/middleware/csrf.d.ts +28 -95
  138. package/dist/http/middleware/detect-locale.d.ts +7 -27
  139. package/dist/http/middleware/force-https.d.ts +6 -24
  140. package/dist/http/middleware/host-authorization.d.ts +2 -12
  141. package/dist/http/middleware/index.d.ts +1 -1
  142. package/dist/http/middleware/loopback-guard.d.ts +15 -33
  143. package/dist/http/middleware/rate-limit.d.ts +29 -126
  144. package/dist/http/middleware/redirect-safety.d.ts +2 -20
  145. package/dist/http/middleware/request-id.d.ts +1 -14
  146. package/dist/http/middleware/request-logging.d.ts +2 -13
  147. package/dist/http/middleware/response-headers.d.ts +5 -13
  148. package/dist/http/middleware/security-headers.d.ts +2 -16
  149. package/dist/http/middleware/session.d.ts +15 -34
  150. package/dist/http/middleware/validation-errors-cookie.d.ts +7 -18
  151. package/dist/http/middleware/validation.d.ts +8 -63
  152. package/dist/http/public-assets.d.ts +11 -7
  153. package/dist/http/request.d.ts +32 -118
  154. package/dist/http/resources/CursorPaginator.d.ts +5 -64
  155. package/dist/http/resources/Paginator.d.ts +7 -84
  156. package/dist/http/resources/Resource.d.ts +9 -65
  157. package/dist/http/resources/ResourceCollection.d.ts +5 -39
  158. package/dist/http/resources/types.d.ts +10 -30
  159. package/dist/http/static-documents.d.ts +10 -20
  160. package/dist/http/validation/Validator.d.ts +25 -85
  161. package/dist/http/validation/rules.d.ts +48 -147
  162. package/dist/http/validation/types.d.ts +16 -61
  163. package/dist/http/vite-assets.d.ts +5 -28
  164. package/dist/http/vite-dev-server.d.ts +6 -9
  165. package/dist/http/vite-manifest.d.ts +19 -33
  166. package/dist/i18n/I18nManager.d.ts +12 -78
  167. package/dist/i18n/Translator.d.ts +3 -54
  168. package/dist/i18n/index.js +1 -1
  169. package/dist/i18n/loaders/JsonLoader.d.ts +4 -31
  170. package/dist/i18n/loaders/MemoryLoader.d.ts +1 -21
  171. package/dist/i18n/pluralization.d.ts +4 -13
  172. package/dist/i18n/types.d.ts +17 -69
  173. package/dist/{i18n-mcWi7LCd.js → i18n-Cg1aajRP.js} +31 -225
  174. package/dist/index.d.ts +11 -4
  175. package/dist/index.js +1186 -3040
  176. package/dist/internal/agent-preflight.d.ts +9 -21
  177. package/dist/internal/agent-principal.d.ts +32 -0
  178. package/dist/internal/request.d.ts +6 -19
  179. package/dist/internal/request.js +1 -1
  180. package/dist/internal/route-path.d.ts +9 -21
  181. package/dist/internal/route-path.js +9 -21
  182. package/dist/internal/zod-compat.d.ts +55 -122
  183. package/dist/internal/zod-compat.js +39 -70
  184. package/dist/internal/zod-json-schema.d.ts +18 -54
  185. package/dist/internal/zod-json-schema.js +46 -123
  186. package/dist/jsx-runtime.d.ts +3 -8
  187. package/dist/lambda/index.d.ts +17 -79
  188. package/dist/lambda/index.js +11 -59
  189. package/dist/logging/LogManager.d.ts +1 -51
  190. package/dist/logging/Logger.d.ts +8 -47
  191. package/dist/logging/channels/ConsoleChannel.d.ts +1 -3
  192. package/dist/logging/channels/DailyFileChannel.d.ts +1 -3
  193. package/dist/logging/channels/FileChannel.d.ts +1 -3
  194. package/dist/logging/daily-file-path.d.ts +7 -16
  195. package/dist/logging/index.js +1 -1
  196. package/dist/logging/types.d.ts +13 -45
  197. package/dist/{logging-B-kngi3q.js → logging-zOY1XCtq.js} +52 -141
  198. package/dist/{loopback-guard-D0Kc7-xc.js → loopback-guard-DT9gHF0F.js} +41 -92
  199. package/dist/mail/Mail.d.ts +10 -106
  200. package/dist/mail/MailManager.d.ts +2 -60
  201. package/dist/mail/index.js +1 -1
  202. package/dist/mail/transports/LogTransport.d.ts +1 -4
  203. package/dist/mail/transports/MemoryTransport.d.ts +1 -63
  204. package/dist/mail/transports/ResendTransport.d.ts +1 -23
  205. package/dist/mail/transports/SmtpTransport.d.ts +1 -31
  206. package/dist/mail/types.d.ts +28 -150
  207. package/dist/{mail-DfEfSQEr.js → mail-76DWy9lj.js} +31 -289
  208. package/dist/mcp/McpServiceProvider.d.ts +4 -10
  209. package/dist/mcp/create-mcp-server.d.ts +42 -57
  210. package/dist/mcp/endpoint.d.ts +12 -36
  211. package/dist/mcp/index.js +1 -1
  212. package/dist/mvc/Controller.d.ts +46 -227
  213. package/dist/mvc/Router.d.ts +50 -129
  214. package/dist/mvc/inertia/InertiaEngine.d.ts +18 -48
  215. package/dist/mvc/inertia/shared.d.ts +6 -19
  216. package/dist/mvc/mount-route.d.ts +2 -6
  217. package/dist/mvc/view.d.ts +1 -2
  218. package/dist/notifications/Notification.d.ts +8 -75
  219. package/dist/notifications/NotificationManager.d.ts +15 -88
  220. package/dist/notifications/channels/DatabaseChannel.d.ts +1 -41
  221. package/dist/notifications/channels/MailChannel.d.ts +2 -31
  222. package/dist/notifications/channels/MemoryChannel.d.ts +2 -62
  223. package/dist/notifications/channels/SlackChannel.d.ts +3 -48
  224. package/dist/notifications/index.js +1 -1
  225. package/dist/notifications/notifiable-type.d.ts +3 -6
  226. package/dist/notifications/registry.d.ts +8 -27
  227. package/dist/notifications/types.d.ts +16 -53
  228. package/dist/{notifications-BGqmUNZ8.js → notifications-okWFs9ly.js} +37 -335
  229. package/dist/providers/AuthServiceProvider.d.ts +1 -3
  230. package/dist/providers/AuthorizationServiceProvider.d.ts +2 -3
  231. package/dist/providers/BroadcastServiceProvider.d.ts +1 -3
  232. package/dist/providers/CacheServiceProvider.d.ts +1 -3
  233. package/dist/providers/EncryptionServiceProvider.d.ts +1 -3
  234. package/dist/providers/ErrorServiceProvider.d.ts +1 -4
  235. package/dist/providers/EventServiceProvider.d.ts +1 -3
  236. package/dist/providers/HealthServiceProvider.d.ts +1 -3
  237. package/dist/providers/I18nServiceProvider.d.ts +6 -10
  238. package/dist/providers/InertiaServiceProvider.d.ts +1 -4
  239. package/dist/providers/LogServiceProvider.d.ts +1 -3
  240. package/dist/providers/MailServiceProvider.d.ts +1 -3
  241. package/dist/providers/NotificationServiceProvider.d.ts +1 -3
  242. package/dist/providers/OAuthServiceProvider.d.ts +1 -3
  243. package/dist/providers/QueueServiceProvider.d.ts +1 -3
  244. package/dist/providers/SchedulingServiceProvider.d.ts +1 -3
  245. package/dist/providers/StorageServiceProvider.d.ts +1 -3
  246. package/dist/queue/FailedJobReporter.d.ts +1 -24
  247. package/dist/queue/Job.d.ts +12 -99
  248. package/dist/queue/QueueManager.d.ts +6 -57
  249. package/dist/queue/Worker.d.ts +4 -65
  250. package/dist/queue/drivers/MemoryDriver.d.ts +3 -44
  251. package/dist/queue/drivers/RedisDriver.d.ts +7 -65
  252. package/dist/queue/drivers/SqsDriver.d.ts +6 -57
  253. package/dist/queue/drivers/SyncDriver.d.ts +10 -13
  254. package/dist/queue/index.js +2 -2
  255. package/dist/queue/types.d.ts +10 -92
  256. package/dist/{queue-CXrRK85G.js → queue-CcXCjuJI.js} +32 -260
  257. package/dist/redis/RedisApiTokenStore.d.ts +4 -56
  258. package/dist/redis/RedisEmailVerificationStore.d.ts +4 -37
  259. package/dist/redis/RedisOAuthStateStore.d.ts +2 -10
  260. package/dist/redis/RedisPasswordResetStore.d.ts +4 -37
  261. package/dist/redis/RedisRateLimitStore.d.ts +16 -49
  262. package/dist/redis/RedisSessionStore.d.ts +3 -44
  263. package/dist/redis/client.d.ts +2 -32
  264. package/dist/redis/index.js +47 -232
  265. package/dist/redis/redis-values.d.ts +6 -12
  266. package/dist/redis/scan-keys.d.ts +1 -4
  267. package/dist/request-CLOYytGP.js +68 -0
  268. package/dist/runtime/index.d.ts +2 -0
  269. package/dist/runtime/index.js +50 -92
  270. package/dist/scheduling/CronParser.d.ts +0 -29
  271. package/dist/scheduling/Schedule.d.ts +1 -153
  272. package/dist/scheduling/ScheduledTask.d.ts +0 -31
  273. package/dist/scheduling/Scheduler.d.ts +0 -70
  274. package/dist/scheduling/index.js +1 -1
  275. package/dist/scheduling/types.d.ts +4 -65
  276. package/dist/{scheduling-CPiEdtQd.js → scheduling-C6tcOtUl.js} +2 -287
  277. package/dist/storage/StorageManager.d.ts +0 -48
  278. package/dist/storage/drivers/LocalDriver.d.ts +1 -25
  279. package/dist/storage/drivers/MemoryDriver.d.ts +5 -35
  280. package/dist/storage/drivers/S3Driver.d.ts +6 -36
  281. package/dist/storage/drivers/s3-acl.d.ts +5 -10
  282. package/dist/storage/index.js +1 -1
  283. package/dist/storage/types.d.ts +27 -265
  284. package/dist/{storage-TLD9t0Q2.js → storage-BB59f07j.js} +17 -157
  285. package/dist/support/contained-path.d.ts +10 -20
  286. package/dist/support/error-polyfill.d.ts +4 -6
  287. package/dist/support/expiry.d.ts +17 -33
  288. package/dist/support/expiry.js +17 -33
  289. package/dist/support/import-map.d.ts +3 -7
  290. package/dist/support/inertia-defaults.d.ts +5 -10
  291. package/dist/support/redirect-target.d.ts +4 -6
  292. package/dist/support/stack-frames.d.ts +11 -50
  293. package/dist/support/trim-slashes.d.ts +4 -7
  294. package/dist/support/warn-once.d.ts +2 -6
  295. package/dist/{trim-slashes-ZJ_VsY5s.js → trim-slashes-BLY9hKAa.js} +4 -7
  296. package/dist/{vite-manifest-w_RSOvQW.js → vite-manifest-B_Iy5183.js} +34 -58
  297. package/package.json +2 -2
  298. package/dist/client-Dd7vLcqp.js +0 -27
  299. package/dist/context-DoD0c7J_.js +0 -26
  300. package/dist/endpoint-D-20PiHY.js +0 -46
  301. package/dist/hot-disposables-WsTX2ySN.js +0 -281
  302. package/dist/request-CVQwpu2J.js +0 -129
@@ -1,6 +1,4 @@
1
1
  /**
2
- * Seeder class interface.
3
- *
4
2
  * @deprecated The constructor shape `BaseSeeder` and `SeederRunner` expect.
5
3
  * Write seeders with `defineSeeder` from `@guren/core` instead. Deprecated in
6
4
  * 2.9.0, removed in 3.0.0.
@@ -9,8 +7,6 @@ export interface SeederClass {
9
7
  new (): Seeder;
10
8
  }
11
9
  /**
12
- * Abstract seeder interface.
13
- *
14
10
  * Exported from the package root as `SeederInterface`.
15
11
  *
16
12
  * @deprecated The no-context `run()` shape `BaseSeeder` imposes. Write seeders
@@ -20,15 +16,9 @@ export interface SeederClass {
20
16
  export interface Seeder {
21
17
  run(): Promise<void>;
22
18
  }
23
- /**
24
- * Factory class interface.
25
- */
26
19
  export interface FactoryClass<T> {
27
20
  new (): Factory<T>;
28
21
  }
29
- /**
30
- * Abstract factory interface.
31
- */
32
22
  export interface Factory<T> {
33
23
  definition(): Partial<T>;
34
24
  make(overrides?: Partial<T>): T;
@@ -37,27 +27,16 @@ export interface Factory<T> {
37
27
  createMany(count: number, overrides?: Partial<T>): Promise<T[]>;
38
28
  }
39
29
  /**
40
- * Seeder runner options.
41
- *
42
30
  * @deprecated Options for `SeederRunner`, which no Guren command reaches.
43
31
  * Write seeders with `defineSeeder` from `@guren/core` and run them with
44
32
  * `db:seed`. Deprecated in 2.9.0, removed in 3.0.0.
45
33
  */
46
34
  export interface SeederRunnerOptions {
47
- /**
48
- * Path to seeders directory.
49
- */
50
35
  seedersPath?: string;
51
- /**
52
- * Default seeder class name.
53
- */
36
+ /** Default seeder class name. */
54
37
  defaultSeeder?: string;
55
- /**
56
- * Force run in production.
57
- */
38
+ /** Force run in production. */
58
39
  force?: boolean;
59
- /**
60
- * Silent mode (no console output).
61
- */
40
+ /** No console output. */
62
41
  silent?: boolean;
63
42
  }
@@ -1,6 +1,3 @@
1
- /**
2
- * Options for configuring the auto-discovery engine.
3
- */
4
1
  export interface DiscoveryOptions {
5
2
  /** Base path for scanning. Defaults to `process.cwd()`. */
6
3
  basePath?: string;
@@ -13,109 +10,40 @@ export interface DiscoveryOptions {
13
10
  /** Whether to discover events in `app/Events/`. Defaults to `true`. */
14
11
  events?: boolean;
15
12
  }
16
- /**
17
- * Result of the auto-discovery scan.
18
- */
19
13
  export interface DiscoveryResult {
20
- /** Discovered service provider classes. */
21
14
  providers: Array<new (...args: unknown[]) => unknown>;
22
- /** Discovered event listeners with their associated event name. */
23
15
  listeners: Array<{
24
16
  event: string;
25
17
  listener: new () => unknown;
26
18
  }>;
27
- /** Discovered job classes. */
28
19
  jobs: Array<new () => unknown>;
29
- /** Discovered event classes. */
30
20
  events: Array<new () => unknown>;
31
21
  }
32
22
  /**
33
- * Auto-discovery engine that scans application directories and discovers
34
- * framework components (providers, listeners, jobs, events).
35
- *
36
- * Standalone by design: nothing in `Application` runs this scan, so
37
- * registration stays explicit — `createApp({ providers: [...] })`, and
38
- * `defineModule` lists for modules — which is what `guren check` verifies
39
- * and what bundle-deploy targets (Workers, Vercel, Lambda) require, since a
40
- * runtime directory scan finds nothing in a bundle. A caller that wants
41
- * discovery runs the scan itself and feeds each result into the matching
42
- * registry, as the example below does.
43
- *
44
- * Uses `Bun.Glob` to scan directories and dynamic `import()` to load modules.
45
- *
46
- * @example
47
- * ```typescript
48
- * const discovery = new AutoDiscovery({ basePath: '/app' })
49
- * const result = await discovery.discover()
50
- *
51
- * // Register discovered providers
52
- * for (const ProviderClass of result.providers) {
53
- * providerManager.register(ProviderClass)
54
- * }
55
- *
56
- * // Register discovered listeners
57
- * for (const { event, listener } of result.listeners) {
58
- * eventManager.listen(event, listener)
59
- * }
60
- * ```
23
+ * Scans application directories for providers, listeners, jobs and events via
24
+ * `Bun.Glob` and dynamic `import()`. Standalone by design: nothing in
25
+ * `Application` runs it, so registration stays explicit — what `guren check`
26
+ * verifies and what bundle-deploy targets (Workers, Vercel, Lambda) require,
27
+ * since a runtime directory scan finds nothing in a bundle.
61
28
  */
62
29
  export declare class AutoDiscovery {
63
30
  private basePath;
64
31
  private options;
65
32
  constructor(options?: DiscoveryOptions);
66
- /**
67
- * Run the discovery scan across all enabled directories.
68
- */
69
33
  discover(): Promise<DiscoveryResult>;
70
- /**
71
- * Discover service providers in `app/Providers/`.
72
- *
73
- * A module is considered a provider if it exports a class (default or named)
74
- * that has a `register` method (i.e., implements the Provider interface).
75
- */
34
+ /** `app/Providers/`: any exported class with a `register` method. */
76
35
  private discoverProviders;
77
- /**
78
- * Discover event listeners in `app/Listeners/`.
79
- *
80
- * A listener class must have a `static event` property (string) that indicates
81
- * which event it handles, and a `handle` method.
82
- */
36
+ /** `app/Listeners/`: classes with a string `static event` and a `handle` method. */
83
37
  private discoverListeners;
84
- /**
85
- * Discover jobs in `app/Jobs/`.
86
- *
87
- * A job class must have a `handle` method.
88
- */
38
+ /** `app/Jobs/`: classes with a `handle` method. */
89
39
  private discoverJobs;
90
- /**
91
- * Discover events in `app/Events/`.
92
- *
93
- * Any exported class from the Events directory is considered an event class.
94
- */
40
+ /** `app/Events/`: every exported class counts. */
95
41
  private discoverEvents;
96
- /**
97
- * Scan a directory for TypeScript files using Bun.Glob.
98
- * Returns an array of imported modules. Skips `index.ts` barrel files.
99
- */
42
+ /** Imports every `.ts` file in the directory, skipping `index.ts` barrels. */
100
43
  private scanDirectory;
101
- /**
102
- * Extract all class constructors (functions) from a module's exports.
103
- */
104
44
  private extractClasses;
105
- /**
106
- * Check if a value is a constructor function (class).
107
- */
108
45
  private isConstructor;
109
- /**
110
- * Check if a class looks like a service provider (has a `register` method).
111
- */
112
46
  private isProvider;
113
- /**
114
- * Get the `static event` property from a class, if it exists and is a string.
115
- */
116
47
  private getStaticEvent;
117
- /**
118
- * Check if a class has a `handle` method on its prototype.
119
- */
120
48
  private hasHandleMethod;
121
49
  }
@@ -1,31 +1,19 @@
1
1
  import { PATH_PARAM_PATTERN } from "./internal/route-path.js";
2
2
  //#region src/internal/agent-preflight.ts
3
3
  /**
4
- * The wire protocol of an agent preflight (RFC 0016 §5.4), in a leaf module
5
- * so the two halves can share it without depending on each other.
6
- *
7
- * `Router` mounts the seam that answers a preflight; `agent/dispatch` builds
8
- * the request that asks for one and reads the answer back. Putting the names
9
- * in either of those would make one import the other — today only
10
- * `dispatch → Router` exists, and the day `Router` needs anything from
11
- * `agent/` that becomes a cycle.
12
- *
13
- * Not exported from the package index: an external dispatcher asks for a
14
- * preflight through `BuildToolRequestOptions.preflight`, and the header
15
- * spelling is this seam's business, not published API.
4
+ * The wire protocol of an agent preflight (RFC 0016 §5.4), in a leaf module so
5
+ * `Router` (which answers one) and `agent/dispatch` (which asks) share it
6
+ * without importing each other and closing a cycle. Not exported from the
7
+ * package index: an external dispatcher goes through
8
+ * `BuildToolRequestOptions.preflight`, and the header spelling stays internal.
16
9
  */
17
10
  /** Request header asking the route for a verdict instead of an execution. */
18
11
  const AGENT_PREFLIGHT_HEADER = "X-Guren-Agent-Preflight";
19
12
  /**
20
- * Response header marking a body as a preflight verdict rather than the
21
- * route's own output.
22
- *
23
- * Load-bearing in two places that would otherwise mistake one for the other:
24
- * a route's `output` schema validation (which would reject the verdict and
25
- * turn it into a 500) and the MCP response mapping (which would advertise the
26
- * verdict as the tool's `structuredContent`, so an SDK client validates it
27
- * against the tool's output schema and throws). Both are answering the same
28
- * question — "is this the route's result?" — so both read the same marker.
13
+ * Response header marking a body as a preflight verdict rather than the route's
14
+ * own output. Read by the route's `output` schema validation (which would
15
+ * otherwise reject the verdict as a 500) and by the MCP response mapping (which
16
+ * would otherwise advertise it as the tool's `structuredContent`).
29
17
  */
30
18
  const AGENT_PREFLIGHT_VERDICT_HEADER = "X-Guren-Agent-Preflight-Verdict";
31
19
  //#endregion
@@ -34,45 +22,28 @@ const AGENT_PREFLIGHT_VERDICT_HEADER = "X-Guren-Agent-Preflight-Verdict";
34
22
  const TEXT_RESPONSE_CAP = 5e4;
35
23
  /**
36
24
  * The argument-level spelling of a preflight request (RFC 0016 §5.4), for a
37
- * surface whose callers pass flat arguments rather than dispatch options.
38
- *
39
- * No adapter strips it today, because none accepts it. Every surface that
40
- * reaches the seam asks through `BuildToolRequestOptions.preflight` instead:
41
- * `guren tool:call` and `@guren/testing` from their own flags, and MCP from
42
- * the `guren.preflight` companion tool, which takes the target tool's name
43
- * and arguments rather than smuggling a directive through them (RFC 0016
44
- * §5.4 — a verdict conforms to no route's output schema, so it needs a tool
45
- * of its own). A surface that adopts this key owns the stripping — it is an
46
- * instruction to the adapter, not a field of any route's contract, and
47
- * forwarding it would fail the very validation the caller asked to rehearse.
25
+ * surface whose callers pass flat arguments rather than dispatch options. No
26
+ * adapter accepts it today — every surface asks through
27
+ * `BuildToolRequestOptions.preflight`. A surface adopting it owns the stripping:
28
+ * it is an instruction to the adapter, not a field of any route's contract.
48
29
  */
49
30
  const PREFLIGHT_ARGUMENT = "_preflight";
50
31
  /**
51
- * The agent-facing diagnosis of a {@link ToolRequestBuildFailure}.
52
- *
53
- * One function rather than a string per adapter: the same tool is reachable
54
- * from several surfaces (App MCP, WebMCP, `guren tool:call`), and an agent
55
- * that reads a different diagnosis depending on which one it reached would
56
- * be debugging the client instead of its own call.
32
+ * The agent-facing diagnosis of a {@link ToolRequestBuildFailure}. One function
33
+ * rather than a string per adapter: the same tool is reachable from several
34
+ * surfaces, and a diagnosis that varied by surface would have an agent
35
+ * debugging the client instead of its own call.
57
36
  */
58
37
  function describeBuildFailure(failure) {
59
38
  if ("missing" in failure) return `Missing required path parameter(s): ${failure.missing.join(", ")}.`;
60
39
  return `Path parameter(s) ${failure.invalidPath.join(", ")} may not be "." or ".." — a dot-segment would resolve to a different route than the one authorized.`;
61
40
  }
62
41
  /**
63
- * Rebuild the HTTP request a tool call describes.
64
- *
65
- * The flat argument object is taken apart along `tool.inputSources` — the
66
- * derivation's own record of which contract each property came from — so a
67
- * POST route's `query` keys land in the query string where `validateQuery`
68
- * reads them, not in the body. Keys the derivation never advertised are
69
- * forwarded anyway (body for body-carrying methods, query otherwise): the
70
- * route's validator is the one place that rejects them, and dropping them
71
- * here would make this a second, quieter validator.
72
- *
73
- * GET and HEAD force everything into the query string whatever its source —
74
- * `Request` refuses a body on those methods, and a `body` schema on a GET
75
- * route is a contract defect this adapter cannot repair.
42
+ * Rebuild the HTTP request a tool call describes. The flat argument object is
43
+ * taken apart along `tool.inputSources`, so a POST route's `query` keys land
44
+ * where `validateQuery` reads them; unadvertised keys are forwarded for the
45
+ * route's validator to reject. GET and HEAD force everything into the query
46
+ * string: `Request` refuses a body there, and a GET `body` schema is a defect.
76
47
  */
77
48
  function buildToolRequest(tool, args, options = {}) {
78
49
  const origin = options.origin ?? "http://localhost";
@@ -161,36 +132,19 @@ function accumulate(entries) {
161
132
  }
162
133
  /**
163
134
  * Whether the tool advertises an object output schema — the only kind MCP
164
- * lists, and therefore the only kind that obliges a success result to carry
165
- * `structuredContent`. A route whose `output` is an array or primitive is not
166
- * advertised as structured (MCP `outputSchema` must be an object), so its
167
- * results ride as text. `describeTool` and `mapToolResponse` must agree on
168
- * this exact predicate, or one advertises a schema the other cannot satisfy.
135
+ * lists, and so the only kind obliging a success result to carry
136
+ * `structuredContent`. `describeTool` and `mapToolResponse` must agree on this
137
+ * exact predicate, or one advertises a schema the other cannot satisfy.
169
138
  */
170
139
  function advertisesStructuredOutput(tool) {
171
140
  return tool.outputSchema?.type === "object";
172
141
  }
173
142
  /**
174
- * Map the application's response onto an MCP tool result (RFC 0016 §3.4).
175
- *
176
- * - 2xx JSON object → serialized text, plus `structuredContent` when the tool
177
- * advertises an object `outputSchema` (the one shape the route validated).
178
- * - 2xx Inertia page JSON → unwrapped to `page.props`, only for a tool with
179
- * no `outputSchema` — unwrap and schema are mutually exclusive by
180
- * derivation, so the advertised shape can never disagree with the result.
181
- * - 204 / 3xx → a status line naming the Location; not an error.
182
- * - 4xx / 5xx → `isError: true` carrying the exception handler's JSON body:
183
- * a 422's `{ message, errors }` is an application-level failure the agent
184
- * should read, not a protocol error.
185
- * - non-JSON → capped text.
186
- *
187
- * One MCP invariant overrides the table: a *non-error* result for a tool that
188
- * advertises an object `outputSchema` must carry `structuredContent`, or the
189
- * SDK client rejects it after the route has already run. A success response
190
- * that yields no object to put there (204, 3xx, non-JSON, a non-object body)
191
- * contradicts the route's own declared output, so it becomes an `isError`
192
- * result naming the mismatch — which the SDK exempts from the rule — rather
193
- * than a protocol fault the agent cannot interpret.
143
+ * Map the application's response onto an MCP tool result (RFC 0016 §3.4): 2xx
144
+ * JSON → text (+ `structuredContent` for an object `outputSchema`); Inertia page
145
+ * JSON → `page.props`; 204/3xx → status line, not an error; 4xx/5xx → `isError`
146
+ * with the handler's body; other → capped text. An object-`outputSchema` success
147
+ * lacking an object becomes `isError`: the SDK client rejects it after the route ran.
194
148
  */
195
149
  async function mapToolResponse(tool, response) {
196
150
  const status = response.status;
@@ -250,9 +204,8 @@ async function mapToolResponse(tool, response) {
250
204
  }
251
205
  /**
252
206
  * A success response that cannot satisfy the tool's advertised object output
253
- * schema. Returned as an error result — the honest signal that the route and
254
- * its declared `output` disagree — which also sidesteps the SDK's
255
- * structuredContent requirement (errors are exempt).
207
+ * schema. An error result is the honest signal that the route and its declared
208
+ * `output` disagree, and it sidesteps the SDK's structuredContent requirement.
256
209
  */
257
210
  function inconsistentOutput(tool, detail, status) {
258
211
  return {
@@ -1,10 +1,7 @@
1
1
  import { ServiceProvider } from '../container/ServiceProvider.js';
2
2
  /**
3
- * Registers the docs viewer (RFC 0005) at /_guren/docs: a read-only,
4
- * loopback-guarded UI that renders the OKF docs bundle as an
5
- * interactive relation graph. Only active while `isDocsViewerEnabled()`
6
- * holds. All routes are GET; the whole bundle ships as one payload, so
7
- * no route takes a path parameter.
3
+ * The docs viewer (RFC 0005) at /_guren/docs: a read-only, loopback-guarded UI
4
+ * over the OKF docs bundle, mounted only while `isDocsViewerEnabled()` holds.
8
5
  */
9
6
  export declare class DocsViewerServiceProvider extends ServiceProvider {
10
7
  register(): void;
@@ -8,17 +8,11 @@
8
8
  import type { MiddlewareHandler } from 'hono';
9
9
  export declare const DOCS_VIEWER_PATH = "/_guren/docs";
10
10
  /**
11
- * Whether the docs viewer is mounted for this process.
12
- *
13
- * Opt-in via `GUREN_DOCS=1` and never active in production: the viewer
14
- * renders the project's private knowledge bundle, so it must not be
15
- * reachable unless the developer asked for it.
16
- *
17
- * The environment reads use plain member access so that the deploy plugins'
18
- * `--define 'process.env.NODE_ENV="production"'` settles the production
19
- * branch at bundle time; an optional chain is a different expression and no
20
- * define matches it. See `mcp/endpoint.ts` for the full reasoning — and do
21
- * not add optional chaining back, a test reads this file for it.
11
+ * Whether the docs viewer is mounted: opt-in via `GUREN_DOCS=1`, never in
12
+ * production — it renders the project's private knowledge bundle. Plain
13
+ * `process.env.X` access on purpose: the deploy plugins' `--define
14
+ * 'process.env.NODE_ENV="production"'` settles that branch at bundle time, and
15
+ * an optional chain is a different expression no define matches (`mcp/endpoint.ts`; a test greps this file).
22
16
  */
23
17
  export declare function isDocsViewerEnabled(): boolean;
24
18
  /**
@@ -1,96 +1,30 @@
1
1
  import type { EncrypterConfig, EncryptOptions, DecryptOptions, EncryptedPayload } from './types.js';
2
- /**
3
- * Encrypter for secure data encryption using AES.
4
- *
5
- * @example
6
- * ```typescript
7
- * const encrypter = new Encrypter({ key: 'base64-encoded-32-byte-key' })
8
- *
9
- * // Encrypt
10
- * const encrypted = encrypter.encrypt({ userId: 123, role: 'admin' })
11
- *
12
- * // Decrypt
13
- * const data = encrypter.decrypt(encrypted)
14
- * ```
15
- */
2
+ /** AES encryption over a base64-encoded 32-byte key. */
16
3
  export declare class Encrypter {
17
- /**
18
- * Encryption key.
19
- */
20
4
  protected key: Buffer;
21
5
  protected previousKeys: Buffer[];
22
- /**
23
- * Cipher algorithm.
24
- */
25
6
  protected cipher: 'aes-256-gcm' | 'aes-256-cbc';
26
7
  constructor(config: EncrypterConfig);
27
- /**
28
- * Encrypt a value.
29
- */
30
8
  encrypt(value: unknown, options?: EncryptOptions): string;
31
- /**
32
- * Decrypt a value.
33
- */
34
9
  decrypt<T = unknown>(payload: string, options?: DecryptOptions): T;
35
- /**
36
- * Encrypt a string (no serialization).
37
- */
38
10
  encryptString(value: string): string;
39
- /**
40
- * Decrypt a string (no deserialization).
41
- */
42
11
  decryptString(payload: string): string;
43
- /**
44
- * Encrypt using AES-256-GCM.
45
- */
46
12
  protected encryptGcm(data: string): string;
47
- /**
48
- * Decrypt using AES-256-GCM.
49
- */
50
13
  protected decryptGcm(payload: EncryptedPayload): string;
51
- /**
52
- * Encrypt using AES-256-CBC with HMAC.
53
- */
54
14
  protected encryptCbc(data: string): string;
55
- /**
56
- * Decrypt using AES-256-CBC with HMAC verification.
57
- */
58
15
  protected decryptCbc(payload: EncryptedPayload): string;
59
- /**
60
- * Create HMAC for CBC mode.
61
- */
62
16
  protected createMac(iv: Buffer, encrypted: Buffer, key?: Buffer): string;
63
- /**
64
- * Constant-time string comparison.
65
- */
17
+ /** Constant-time comparison. */
66
18
  protected secureCompare(a: string, b: string): boolean;
67
- /**
68
- * Get the encryption key (base64).
69
- */
19
+ /** The encryption key, base64-encoded. */
70
20
  getKey(): string;
71
21
  protected tryDecryptWithKeys(run: (key: Buffer) => string): string;
72
22
  }
73
- /**
74
- * Generate a random encryption key.
75
- */
76
23
  export declare function generateKey(): string;
77
- /**
78
- * Create an encrypter instance.
79
- */
80
24
  export declare function createEncrypter(config: EncrypterConfig): Encrypter;
81
- /**
82
- * Set the global encrypter.
83
- */
84
25
  export declare function setEncrypter(encrypter: Encrypter): void;
85
- /**
86
- * Get the global encrypter.
87
- */
88
26
  export declare function getEncrypter(): Encrypter;
89
- /**
90
- * Encrypt a value using the global encrypter.
91
- */
27
+ /** Encrypt with the global encrypter. */
92
28
  export declare function encrypt(value: unknown, options?: EncryptOptions): string;
93
- /**
94
- * Decrypt a value using the global encrypter.
95
- */
29
+ /** Decrypt with the global encrypter. */
96
30
  export declare function decrypt<T = unknown>(payload: string, options?: DecryptOptions): T;
@@ -1,69 +1,19 @@
1
1
  import type { HashAlgorithm, HmacOptions, PasswordHashOptions } from './types.js';
2
- /**
3
- * Hash a value using the specified algorithm.
4
- *
5
- * @example
6
- * ```typescript
7
- * hash('hello') // SHA-256 by default
8
- * hash('hello', 'sha512')
9
- * hash('hello', 'md5')
10
- * ```
11
- */
2
+ /** Hash a value; SHA-256 by default. */
12
3
  export declare function hash(value: string | Buffer, algorithm?: HashAlgorithm, encoding?: 'hex' | 'base64'): string;
13
- /**
14
- * Create an HMAC signature.
15
- *
16
- * @example
17
- * ```typescript
18
- * hmac('message', 'secret-key')
19
- * hmac('message', 'secret-key', { algorithm: 'sha512' })
20
- * ```
21
- */
4
+ /** Create an HMAC signature; SHA-256 by default. */
22
5
  export declare function hmac(value: string | Buffer, key: string | Buffer, options?: HmacOptions): string;
23
- /**
24
- * Verify an HMAC signature.
25
- */
26
6
  export declare function verifyHmac(value: string | Buffer, signature: string, key: string | Buffer, options?: HmacOptions): boolean;
27
- /**
28
- * Create a SHA-256 hash.
29
- */
30
7
  export declare function sha256(value: string | Buffer): string;
31
- /**
32
- * Create a SHA-512 hash.
33
- */
34
8
  export declare function sha512(value: string | Buffer): string;
35
- /**
36
- * Create an MD5 hash (not secure, use only for checksums).
37
- */
9
+ /** Not secure — checksums only. */
38
10
  export declare function md5(value: string | Buffer): string;
39
- /**
40
- * Hash a password using scrypt.
41
- *
42
- * @example
43
- * ```typescript
44
- * const hashed = await hashPassword('mypassword')
45
- * // Returns: $scrypt$N=16384,r=8,p=1$salt$hash
46
- * ```
47
- */
11
+ /** scrypt, returning `$scrypt$N=16384,r=8,p=1$salt$hash`. */
48
12
  export declare function hashPassword(password: string, options?: PasswordHashOptions): Promise<string>;
49
- /**
50
- * Verify a password against a hash.
51
- *
52
- * @example
53
- * ```typescript
54
- * const isValid = await verifyPassword('mypassword', hashedPassword)
55
- * ```
56
- */
13
+ /** Verify a password against a hash. */
57
14
  export declare function verifyPassword(password: string, hash: string): Promise<boolean>;
58
- /**
59
- * Check if a password needs to be rehashed (parameters changed).
60
- */
15
+ /** Whether the hash was made with different parameters than `options`. */
61
16
  export declare function needsRehash(hash: string, options?: PasswordHashOptions): boolean;
62
- /**
63
- * Constant-time string comparison.
64
- */
17
+ /** Constant-time comparison. */
65
18
  export declare function secureCompare(a: string, b: string): boolean;
66
- /**
67
- * Check if a value matches a hash.
68
- */
69
19
  export declare function check(value: string | Buffer, hash: string, algorithm?: HashAlgorithm): boolean;