@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,54 +1,21 @@
1
1
  import type { Redis } from 'ioredis';
2
2
  import type { EmailVerificationTokenStore, EmailVerificationToken } from '../auth/email-verification.js';
3
- /**
4
- * Options for RedisEmailVerificationStore.
5
- */
6
3
  export interface RedisEmailVerificationStoreOptions {
7
- /**
8
- * Key prefix for email verification keys.
9
- * @default 'emailverify:'
10
- */
4
+ /** @default 'emailverify:' */
11
5
  prefix?: string;
12
6
  }
13
7
  /**
14
- * Redis-backed email verification token store.
15
- *
16
- * Uses the following key structure:
17
- * - `emailverify:{tokenId}` - Token data (JSON)
18
- * - `emailverify:email:{email}` - Set of token IDs for an email
19
- *
20
- * @example
21
- * ```ts
22
- * import { createRedisClient } from '@guren/server/redis'
23
- *
24
- * const redis = createRedisClient({ url: process.env.REDIS_URL })
25
- * const store = new RedisEmailVerificationStore(redis)
26
- *
27
- * const { token } = await createEmailVerificationToken(email, store, { expiresIn: 86400000 })
28
- * ```
8
+ * Key layout: `emailverify:{tokenId}` JSON token data,
9
+ * `emailverify:email:{email}` Set of an email's token IDs.
29
10
  */
30
11
  export declare class RedisEmailVerificationStore implements EmailVerificationTokenStore {
31
12
  private readonly redis;
32
13
  private readonly prefix;
33
14
  constructor(redis: Redis, options?: RedisEmailVerificationStoreOptions);
34
- /**
35
- * Store an email verification token.
36
- */
37
15
  store(token: EmailVerificationToken): Promise<void>;
38
- /**
39
- * Find a token by its hash.
40
- */
41
16
  findByTokenId(tokenId: string): Promise<EmailVerificationToken | null>;
42
- /**
43
- * Delete a token by its hash.
44
- */
45
17
  delete(tokenId: string): Promise<void>;
46
- /**
47
- * Delete all tokens for an email.
48
- */
49
18
  deleteForEmail(email: string): Promise<void>;
50
- /**
51
- * Clear all tokens (for testing).
52
- */
19
+ /** Testing only. */
53
20
  clear(): Promise<void>;
54
21
  }
@@ -1,13 +1,7 @@
1
1
  import type { Redis } from 'ioredis';
2
2
  import type { OAuthStatePayload, OAuthStateStore } from '../auth/oauth/index.js';
3
- /**
4
- * Options for RedisOAuthStateStore.
5
- */
6
3
  export interface RedisOAuthStateStoreOptions {
7
- /**
8
- * Key prefix for OAuth state keys.
9
- * @default 'oauthstate:'
10
- */
4
+ /** @default 'oauthstate:' */
11
5
  prefix?: string;
12
6
  }
13
7
  export declare class RedisOAuthStateStore implements OAuthStateStore {
@@ -19,8 +13,6 @@ export declare class RedisOAuthStateStore implements OAuthStateStore {
19
13
  consume(stateHash: string): Promise<OAuthStatePayload | null>;
20
14
  private parsePayload;
21
15
  delete(stateHash: string): Promise<void>;
22
- /**
23
- * Clear all states (for testing).
24
- */
16
+ /** Testing only. */
25
17
  clear(): Promise<void>;
26
18
  }
@@ -1,57 +1,24 @@
1
1
  import type { Redis } from 'ioredis';
2
2
  import type { PasswordResetTokenStore } from '../auth/password-reset.js';
3
- /**
4
- * Options for RedisPasswordResetStore.
5
- */
6
3
  export interface RedisPasswordResetStoreOptions {
7
- /**
8
- * Key prefix for password reset keys.
9
- * @default 'pwreset:'
10
- */
4
+ /** @default 'pwreset:' */
11
5
  prefix?: string;
12
6
  }
13
7
  /**
14
- * Redis-backed password reset token store.
15
- *
16
- * Uses the following key structure:
17
- * - `pwreset:{tokenId}` - Token data (JSON with email and expiresAt)
18
- * - `pwreset:email:{email}` - Set of token IDs for an email
19
- *
20
- * @example
21
- * ```ts
22
- * import { createRedisClient } from '@guren/server/redis'
23
- *
24
- * const redis = createRedisClient({ url: process.env.REDIS_URL })
25
- * const store = new RedisPasswordResetStore(redis)
26
- *
27
- * const { token } = await createPasswordResetToken(email, store, { expiresIn: 3600000 })
28
- * ```
8
+ * Key layout: `pwreset:{tokenId}` JSON of email + expiresAt,
9
+ * `pwreset:email:{email}` Set of an email's token IDs.
29
10
  */
30
11
  export declare class RedisPasswordResetStore implements PasswordResetTokenStore {
31
12
  private readonly redis;
32
13
  private readonly prefix;
33
14
  constructor(redis: Redis, options?: RedisPasswordResetStoreOptions);
34
- /**
35
- * Store a password reset token.
36
- */
37
15
  store(tokenId: string, email: string, expiresAt: Date): Promise<void>;
38
- /**
39
- * Find a token by its hash.
40
- */
41
16
  find(tokenId: string): Promise<{
42
17
  email: string;
43
18
  expiresAt: Date;
44
19
  } | null>;
45
- /**
46
- * Delete a token by its hash.
47
- */
48
20
  delete(tokenId: string): Promise<void>;
49
- /**
50
- * Delete all tokens for an email.
51
- */
52
21
  deleteForEmail(email: string): Promise<void>;
53
- /**
54
- * Clear all tokens (for testing).
55
- */
22
+ /** Testing only. */
56
23
  clear(): Promise<void>;
57
24
  }
@@ -1,77 +1,44 @@
1
1
  import type { Redis } from 'ioredis';
2
2
  import type { RateLimitStore, RateLimitEntry } from '../http/middleware/rate-limit.js';
3
- /**
4
- * Options for RedisRateLimitStore.
5
- */
6
3
  export interface RedisRateLimitStoreOptions {
7
- /**
8
- * Key prefix for rate limit keys.
9
- * @default 'ratelimit:'
10
- */
4
+ /** @default 'ratelimit:' */
11
5
  prefix?: string;
12
6
  }
13
7
  /**
14
- * Redis-backed rate limit store using fixed window algorithm.
15
- * Uses Lua script for atomic increment operations.
16
- *
17
- * @example
18
- * ```ts
19
- * import { createRedisClient } from '@guren/server/redis'
20
- *
21
- * const redis = createRedisClient({ url: process.env.REDIS_URL })
22
- * const store = new RedisRateLimitStore(redis)
23
- *
24
- * app.use(createRateLimitMiddleware({ store, limit: 100 }))
25
- * ```
8
+ * Returns [count, resetAt]. Exported for the in-memory fake in tests, which
9
+ * recognises the script by identity; not part of the public surface.
10
+ */
11
+ export declare const INCREMENT_SCRIPT = "\nlocal key = KEYS[1]\nlocal window = tonumber(ARGV[1])\nlocal now = tonumber(ARGV[2])\n\nlocal count = redis.call('INCR', key)\nif count == 1 then\n redis.call('PEXPIRE', key, window)\nend\nlocal ttl = redis.call('PTTL', key)\nlocal resetAt = now + ttl\nreturn {count, resetAt}\n";
12
+ /**
13
+ * Trim entries that fell out of the window, record this request, count what is
14
+ * left, and refresh the expiry as one atomic step; returns the count. A pipeline
15
+ * is not a substitute: Redis still interleaves other clients' commands between
16
+ * its steps, so two concurrent callers could both ZADD before either ZCARD and
17
+ * read the same count. The caller generates the member so the script stays deterministic.
26
18
  */
19
+ export declare const SLIDING_WINDOW_SCRIPT = "\nlocal key = KEYS[1]\nlocal window = tonumber(ARGV[1])\nlocal now = tonumber(ARGV[2])\nlocal member = ARGV[3]\n\nredis.call('ZREMRANGEBYSCORE', key, '-inf', now - window)\nredis.call('ZADD', key, now, member)\nlocal count = redis.call('ZCARD', key)\nredis.call('PEXPIRE', key, window)\nreturn count\n";
20
+ /** Fixed-window rate limiting; the Lua script keeps the increment atomic. */
27
21
  export declare class RedisRateLimitStore implements RateLimitStore {
28
22
  private readonly redis;
29
23
  private readonly prefix;
30
24
  constructor(redis: Redis, options?: RedisRateLimitStoreOptions);
31
- /**
32
- * Get current rate limit entry for a key.
33
- */
34
25
  get(key: string): Promise<RateLimitEntry | null>;
35
- /**
36
- * Increment the rate limit counter atomically.
37
- */
38
26
  increment(key: string, windowMs: number): Promise<RateLimitEntry>;
39
- /**
40
- * Reset the rate limit for a key.
41
- */
42
27
  reset(key: string): Promise<void>;
43
- /**
44
- * Get all rate limit keys (for debugging/admin purposes).
45
- */
28
+ /** Debugging/admin. */
46
29
  keys(): Promise<string[]>;
47
- /**
48
- * Clear all rate limits.
49
- */
50
30
  clear(): Promise<void>;
51
31
  }
52
32
  /**
53
- * Redis-backed rate limit store using sliding window algorithm.
54
- * More accurate than fixed window but slightly more expensive.
33
+ * Sliding window: more accurate than the fixed window, slightly more expensive.
34
+ * The Lua script keeps trim, insert, and count atomic.
55
35
  */
56
36
  export declare class RedisSlidingWindowRateLimitStore implements RateLimitStore {
57
37
  private readonly redis;
58
38
  private readonly prefix;
59
39
  constructor(redis: Redis, options?: RedisRateLimitStoreOptions);
60
- /**
61
- * Get current rate limit entry for a key.
62
- */
63
40
  get(key: string): Promise<RateLimitEntry | null>;
64
- /**
65
- * Increment the rate limit counter using sorted set.
66
- * Each request is stored with its timestamp as score.
67
- */
68
41
  increment(key: string, windowMs: number): Promise<RateLimitEntry>;
69
- /**
70
- * Reset the rate limit for a key.
71
- */
72
42
  reset(key: string): Promise<void>;
73
- /**
74
- * Clear all rate limits.
75
- */
76
43
  clear(): Promise<void>;
77
44
  }
@@ -1,61 +1,20 @@
1
1
  import type { Redis } from 'ioredis';
2
2
  import type { SessionStore, SessionData } from '../http/middleware/session.js';
3
- /**
4
- * Options for RedisSessionStore.
5
- */
6
3
  export interface RedisSessionStoreOptions {
7
- /**
8
- * Key prefix for session keys.
9
- * @default 'session:'
10
- */
4
+ /** @default 'session:' */
11
5
  prefix?: string;
12
6
  }
13
- /**
14
- * Redis-backed session store.
15
- *
16
- * @example
17
- * ```ts
18
- * import { createRedisClient } from '@guren/server/redis'
19
- *
20
- * const redis = createRedisClient({ url: process.env.REDIS_URL })
21
- * const store = new RedisSessionStore(redis)
22
- *
23
- * app.use(createSessionMiddleware({ store }))
24
- * ```
25
- */
26
7
  export declare class RedisSessionStore implements SessionStore {
27
8
  private readonly redis;
28
9
  private readonly prefix;
29
10
  constructor(redis: Redis, options?: RedisSessionStoreOptions);
30
- /**
31
- * Read session data from Redis.
32
- */
33
11
  read(id: string): Promise<SessionData | undefined>;
34
- /**
35
- * Write session data to Redis with TTL.
36
- */
37
12
  write(id: string, data: SessionData, ttlSeconds: number): Promise<void>;
38
- /**
39
- * Delete a session from Redis.
40
- */
41
13
  destroy(id: string): Promise<void>;
42
- /**
43
- * Refresh an existing session's TTL without rewriting its data.
44
- * EXPIRE on a missing key is a no-op, never a resurrection.
45
- */
14
+ /** EXPIRE on a missing key is a no-op, never a resurrection. */
46
15
  touch(id: string, ttlSeconds: number): Promise<void>;
47
- /**
48
- * Get all session keys (for debugging/admin purposes).
49
- * Note: This uses SCAN to avoid blocking Redis.
50
- */
16
+ /** Debugging/admin. */
51
17
  keys(): Promise<string[]>;
52
- /**
53
- * Get the count of sessions (for monitoring).
54
- */
55
18
  size(): Promise<number>;
56
- /**
57
- * Clear all sessions.
58
- * Use with caution in production!
59
- */
60
19
  clear(): Promise<void>;
61
20
  }
@@ -1,41 +1,11 @@
1
1
  import Redis from 'ioredis';
2
2
  import type { RedisOptions } from 'ioredis';
3
- /**
4
- * Options for creating a Redis client.
5
- */
6
3
  export interface RedisClientOptions extends RedisOptions {
7
- /**
8
- * Redis connection URL (e.g., 'redis://localhost:6379').
9
- * If provided, overrides host/port/password.
10
- */
4
+ /** Overrides host/port/password when set. */
11
5
  url?: string;
12
- /**
13
- * Key prefix for all operations.
14
- * @default ''
15
- */
6
+ /** @default '' */
16
7
  keyPrefix?: string;
17
8
  }
18
- /**
19
- * Create a Redis client with the given options.
20
- *
21
- * @example
22
- * ```ts
23
- * // Using URL
24
- * const redis = createRedisClient({ url: 'redis://localhost:6379' })
25
- *
26
- * // Using host/port
27
- * const redis = createRedisClient({ host: 'localhost', port: 6379 })
28
- *
29
- * // With key prefix
30
- * const redis = createRedisClient({
31
- * url: process.env.REDIS_URL,
32
- * keyPrefix: 'myapp:',
33
- * })
34
- * ```
35
- */
36
9
  export declare function createRedisClient(options?: RedisClientOptions): Redis;
37
- /**
38
- * Re-export Redis class for type usage.
39
- */
40
10
  export { Redis };
41
11
  export type { RedisOptions };