@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,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 };