@guren/server 2.1.1 → 2.2.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 (270) hide show
  1. package/dist/{McpServiceProvider-7BB5FPF3.js → McpServiceProvider-GRDYNEQG.js} +1 -1
  2. package/dist/auth/AuthManager.d.ts +30 -0
  3. package/dist/auth/AuthenticatableModel.d.ts +25 -0
  4. package/dist/auth/RequestAuthContext.d.ts +24 -0
  5. package/dist/auth/SessionGuard.d.ts +31 -0
  6. package/dist/auth/api-token.d.ts +299 -0
  7. package/dist/auth/email-verification.d.ts +203 -0
  8. package/dist/auth/index.d.ts +18 -110
  9. package/dist/auth/index.js +3 -1
  10. package/dist/auth/oauth/index.d.ts +239 -0
  11. package/dist/auth/password/DefaultHasher.d.ts +13 -0
  12. package/dist/auth/password/NodeHasher.d.ts +22 -0
  13. package/dist/auth/password/PasswordHasher.d.ts +5 -0
  14. package/dist/auth/password/ScryptHasher.d.ts +26 -0
  15. package/dist/auth/password-reset.d.ts +91 -0
  16. package/dist/auth/providers/ModelUserProvider.d.ts +36 -0
  17. package/dist/auth/providers/UserProvider.d.ts +9 -0
  18. package/dist/auth/types.d.ts +102 -0
  19. package/dist/auth/utils.d.ts +39 -0
  20. package/dist/{Gate-CynjZCtS.d.ts → authorization/Gate.d.ts} +30 -111
  21. package/dist/authorization/Policy.d.ts +77 -0
  22. package/dist/authorization/index.d.ts +5 -129
  23. package/dist/authorization/index.js +3 -1
  24. package/dist/authorization/middleware.d.ts +49 -0
  25. package/dist/authorization/types.d.ts +108 -0
  26. package/dist/broadcasting/BroadcastManager.d.ts +205 -0
  27. package/dist/broadcasting/channels/Channel.d.ts +28 -0
  28. package/dist/broadcasting/channels/PresenceChannel.d.ts +72 -0
  29. package/dist/broadcasting/channels/PrivateChannel.d.ts +32 -0
  30. package/dist/broadcasting/channels/index.d.ts +3 -0
  31. package/dist/broadcasting/drivers/MemoryDriver.d.ts +93 -0
  32. package/dist/broadcasting/drivers/RedisDriver.d.ts +112 -0
  33. package/dist/broadcasting/drivers/index.d.ts +2 -0
  34. package/dist/broadcasting/index.d.ts +6 -233
  35. package/dist/broadcasting/index.js +1 -1
  36. package/dist/broadcasting/typed.d.ts +23 -0
  37. package/dist/broadcasting/types.d.ts +155 -0
  38. package/dist/cache/CacheManager.d.ts +87 -0
  39. package/dist/cache/TaggedCache.d.ts +62 -0
  40. package/dist/cache/index.d.ts +6 -233
  41. package/dist/cache/index.js +1 -1
  42. package/dist/cache/stores/FileStore.d.ts +64 -0
  43. package/dist/cache/stores/MemoryStore.d.ts +52 -0
  44. package/dist/cache/stores/RedisStore.d.ts +53 -0
  45. package/dist/{CacheManager-BmDzUKrF.d.ts → cache/types.d.ts} +26 -99
  46. package/dist/{chunk-TVY72CLV.js → chunk-4VE3LYOM.js} +3 -2
  47. package/dist/{chunk-FZD2AKJI.js → chunk-7OB2YXRE.js} +56 -28
  48. package/dist/{chunk-J6ETA476.js → chunk-BUQXOZCT.js} +93 -5
  49. package/dist/{chunk-DSDX3ASM.js → chunk-CDZUNKI6.js} +65 -83
  50. package/dist/{chunk-CWI4AJ47.js → chunk-HPET6XY5.js} +13 -9
  51. package/dist/{chunk-A3ISJVEV.js → chunk-HR2KZ3WL.js} +23 -5
  52. package/dist/{chunk-5SZTEZ22.js → chunk-PZKUDFMW.js} +11 -8
  53. package/dist/console/Command.d.ts +179 -0
  54. package/dist/{ConsoleKernel-CJg975mp.d.ts → console/ConsoleKernel.d.ts} +4 -6
  55. package/dist/console/Input.d.ts +140 -0
  56. package/dist/console/Output.d.ts +161 -0
  57. package/dist/console/index.d.ts +5 -0
  58. package/dist/console/types.d.ts +106 -0
  59. package/dist/container/Container.d.ts +148 -0
  60. package/dist/container/ServiceProvider.d.ts +103 -0
  61. package/dist/container/bindings.d.ts +55 -0
  62. package/dist/container/defineModule.d.ts +88 -0
  63. package/dist/container/definePlugin.d.ts +62 -0
  64. package/dist/container/index.d.ts +8 -0
  65. package/dist/container/types.d.ts +73 -0
  66. package/dist/database/Factory.d.ts +82 -0
  67. package/dist/database/Seeder.d.ts +35 -0
  68. package/dist/database/SeederRunner.d.ts +41 -0
  69. package/dist/database/index.d.ts +4 -0
  70. package/dist/database/types.d.ts +49 -0
  71. package/dist/discovery/AutoDiscovery.d.ts +113 -0
  72. package/dist/discovery/index.d.ts +2 -0
  73. package/dist/docs-viewer/DocsViewerServiceProvider.d.ts +12 -0
  74. package/dist/docs-viewer/endpoint.d.ts +19 -0
  75. package/dist/encryption/Encrypter.d.ts +96 -0
  76. package/dist/encryption/Hash.d.ts +69 -0
  77. package/dist/encryption/MessageSigner.d.ts +21 -0
  78. package/dist/encryption/Random.d.ts +119 -0
  79. package/dist/encryption/app-key.d.ts +12 -0
  80. package/dist/encryption/index.d.ts +10 -222
  81. package/dist/encryption/signed-url.d.ts +9 -0
  82. package/dist/encryption/types.d.ts +103 -0
  83. package/dist/errors/ExceptionHandler.d.ts +118 -0
  84. package/dist/errors/HttpException.d.ts +106 -0
  85. package/dist/errors/debug-page.d.ts +22 -0
  86. package/dist/errors/error-page.d.ts +1 -0
  87. package/dist/errors/exceptions/AuthenticationException.d.ts +32 -0
  88. package/dist/errors/exceptions/AuthorizationException.d.ts +32 -0
  89. package/dist/errors/exceptions/MethodNotAllowedException.d.ts +31 -0
  90. package/dist/errors/exceptions/NotFoundHttpException.d.ts +36 -0
  91. package/dist/errors/exceptions/ValidationException.d.ts +60 -0
  92. package/dist/errors/exceptions/index.d.ts +5 -0
  93. package/dist/errors/index.d.ts +5 -0
  94. package/dist/errors/types.d.ts +43 -0
  95. package/dist/events/Event.d.ts +33 -0
  96. package/dist/{EventManager-CmIoLt7r.d.ts → events/EventManager.d.ts} +4 -86
  97. package/dist/events/Listener.d.ts +79 -0
  98. package/dist/events/builtin.d.ts +73 -0
  99. package/dist/events/index.d.ts +6 -155
  100. package/dist/events/types.d.ts +48 -0
  101. package/dist/facades/index.d.ts +31 -0
  102. package/dist/health/HealthCheck.d.ts +34 -0
  103. package/dist/health/HealthManager.d.ts +53 -0
  104. package/dist/health/checks/CacheCheck.d.ts +35 -0
  105. package/dist/health/checks/CustomCheck.d.ts +23 -0
  106. package/dist/health/checks/DatabaseCheck.d.ts +33 -0
  107. package/dist/health/checks/MemoryCheck.d.ts +32 -0
  108. package/dist/health/checks/RedisCheck.d.ts +27 -0
  109. package/dist/health/checks/StorageCheck.d.ts +35 -0
  110. package/dist/health/checks/index.d.ts +12 -0
  111. package/dist/health/index.d.ts +5 -185
  112. package/dist/health/types.d.ts +52 -0
  113. package/dist/hot-reload/hot-disposables.d.ts +96 -0
  114. package/dist/hot-reload/testing.d.ts +14 -0
  115. package/dist/http/Application.d.ts +187 -0
  116. package/dist/http/FormRequest.d.ts +73 -0
  117. package/dist/http/dev-assets.d.ts +51 -0
  118. package/dist/http/dev-banner.d.ts +7 -0
  119. package/dist/http/inertia-assets.d.ts +22 -0
  120. package/dist/http/middleware/auth.d.ts +13 -0
  121. package/dist/http/middleware/capabilities.d.ts +22 -0
  122. package/dist/http/middleware/cors.d.ts +40 -0
  123. package/dist/http/middleware/csp.d.ts +59 -0
  124. package/dist/http/middleware/csrf.d.ts +121 -0
  125. package/dist/http/middleware/detect-locale.d.ts +65 -0
  126. package/dist/http/middleware/force-https.d.ts +34 -0
  127. package/dist/http/middleware/host-authorization.d.ts +24 -0
  128. package/dist/http/middleware/index.d.ts +19 -0
  129. package/dist/http/middleware/loopback-guard.d.ts +38 -0
  130. package/dist/{rate-limit-D9J2b4S1.d.ts → http/middleware/rate-limit.d.ts} +22 -50
  131. package/dist/http/middleware/redirect-safety.d.ts +29 -0
  132. package/dist/http/middleware/request-id.d.ts +19 -0
  133. package/dist/http/middleware/request-logging.d.ts +16 -0
  134. package/dist/http/middleware/security-headers.d.ts +49 -0
  135. package/dist/http/middleware/session.d.ts +93 -0
  136. package/dist/http/middleware/validation.d.ts +94 -0
  137. package/dist/http/public-assets.d.ts +15 -0
  138. package/dist/http/request.d.ts +24 -0
  139. package/dist/http/resources/CursorPaginator.d.ts +106 -0
  140. package/dist/http/resources/Paginator.d.ts +130 -0
  141. package/dist/http/resources/Resource.d.ts +67 -0
  142. package/dist/http/resources/ResourceCollection.d.ts +60 -0
  143. package/dist/http/resources/index.d.ts +6 -0
  144. package/dist/http/resources/types.d.ts +91 -0
  145. package/dist/http/validation/Validator.d.ts +128 -0
  146. package/dist/http/validation/index.d.ts +3 -0
  147. package/dist/http/validation/rules.d.ts +196 -0
  148. package/dist/http/validation/types.d.ts +96 -0
  149. package/dist/http/vite-dev-server.d.ts +27 -0
  150. package/dist/i18n/I18nManager.d.ts +114 -0
  151. package/dist/i18n/Translator.d.ts +80 -0
  152. package/dist/i18n/index.d.ts +6 -101
  153. package/dist/i18n/index.js +5 -3
  154. package/dist/i18n/loaders/JsonLoader.d.ts +47 -0
  155. package/dist/i18n/loaders/MemoryLoader.d.ts +37 -0
  156. package/dist/i18n/pluralization.d.ts +19 -0
  157. package/dist/i18n/types.d.ts +106 -0
  158. package/dist/index.d.ts +69 -2605
  159. package/dist/index.js +332 -152
  160. package/dist/lambda/index.d.ts +17 -37
  161. package/dist/logging/LogManager.d.ts +83 -0
  162. package/dist/logging/Logger.d.ts +76 -0
  163. package/dist/logging/channels/ConsoleChannel.d.ts +11 -0
  164. package/dist/logging/channels/DailyFileChannel.d.ts +20 -0
  165. package/dist/logging/channels/FileChannel.d.ts +15 -0
  166. package/dist/logging/index.d.ts +8 -50
  167. package/dist/logging/types.d.ts +96 -0
  168. package/dist/mail/Mail.d.ts +138 -0
  169. package/dist/mail/MailManager.d.ts +79 -0
  170. package/dist/mail/address.d.ts +8 -0
  171. package/dist/mail/index.d.ts +7 -316
  172. package/dist/mail/transports/LogTransport.d.ts +19 -0
  173. package/dist/mail/transports/MemoryTransport.d.ts +84 -0
  174. package/dist/mail/transports/ResendTransport.d.ts +32 -0
  175. package/dist/mail/transports/SmtpTransport.d.ts +40 -0
  176. package/dist/{MailManager-DpMvYiP9.d.ts → mail/types.d.ts} +11 -92
  177. package/dist/mcp/McpServiceProvider.d.ts +17 -0
  178. package/dist/mcp/create-mcp-server.d.ts +144 -0
  179. package/dist/mcp/endpoint.d.ts +29 -0
  180. package/dist/mcp/index.d.ts +3 -185
  181. package/dist/mcp/index.js +1 -1
  182. package/dist/mvc/Controller.d.ts +326 -0
  183. package/dist/mvc/Router.d.ts +239 -0
  184. package/dist/mvc/ViewEngine.d.ts +11 -0
  185. package/dist/mvc/inertia/InertiaEngine.d.ts +114 -0
  186. package/dist/mvc/inertia/shared.d.ts +90 -0
  187. package/dist/mvc/mount-route.d.ts +10 -0
  188. package/dist/notifications/Notification.d.ts +99 -0
  189. package/dist/notifications/NotificationManager.d.ts +150 -0
  190. package/dist/notifications/channels/DatabaseChannel.d.ts +55 -0
  191. package/dist/notifications/channels/MailChannel.d.ts +45 -0
  192. package/dist/notifications/channels/MemoryChannel.d.ts +85 -0
  193. package/dist/notifications/channels/SlackChannel.d.ts +73 -0
  194. package/dist/notifications/channels/index.d.ts +4 -0
  195. package/dist/notifications/index.d.ts +6 -322
  196. package/dist/notifications/notifiable-type.d.ts +10 -0
  197. package/dist/notifications/registry.d.ts +39 -0
  198. package/dist/notifications/types.d.ts +162 -0
  199. package/dist/providers/AuthServiceProvider.d.ts +7 -0
  200. package/dist/providers/AuthorizationServiceProvider.d.ts +9 -0
  201. package/dist/providers/BroadcastServiceProvider.d.ts +7 -0
  202. package/dist/providers/CacheServiceProvider.d.ts +7 -0
  203. package/dist/providers/EncryptionServiceProvider.d.ts +7 -0
  204. package/dist/providers/ErrorServiceProvider.d.ts +9 -0
  205. package/dist/providers/EventServiceProvider.d.ts +7 -0
  206. package/dist/providers/HealthServiceProvider.d.ts +7 -0
  207. package/dist/providers/I18nServiceProvider.d.ts +27 -0
  208. package/dist/providers/InertiaServiceProvider.d.ts +20 -0
  209. package/dist/providers/LogServiceProvider.d.ts +7 -0
  210. package/dist/providers/MailServiceProvider.d.ts +7 -0
  211. package/dist/providers/NotificationServiceProvider.d.ts +8 -0
  212. package/dist/providers/OAuthServiceProvider.d.ts +7 -0
  213. package/dist/providers/QueueServiceProvider.d.ts +7 -0
  214. package/dist/providers/SchedulingServiceProvider.d.ts +7 -0
  215. package/dist/providers/StorageServiceProvider.d.ts +7 -0
  216. package/dist/providers/index.d.ts +17 -0
  217. package/dist/queue/FailedJobReporter.d.ts +40 -0
  218. package/dist/queue/Job.d.ts +140 -0
  219. package/dist/queue/QueueManager.d.ts +79 -0
  220. package/dist/queue/Worker.d.ts +99 -0
  221. package/dist/queue/drivers/MemoryDriver.d.ts +60 -0
  222. package/dist/queue/drivers/RedisDriver.d.ts +96 -0
  223. package/dist/queue/drivers/SqsDriver.d.ts +108 -0
  224. package/dist/queue/drivers/SyncDriver.d.ts +28 -0
  225. package/dist/queue/index.d.ts +9 -453
  226. package/dist/queue/types.d.ts +171 -0
  227. package/dist/redis/RedisApiTokenStore.d.ts +78 -0
  228. package/dist/redis/RedisEmailVerificationStore.d.ts +54 -0
  229. package/dist/redis/RedisOAuthStateStore.d.ts +26 -0
  230. package/dist/redis/RedisPasswordResetStore.d.ts +57 -0
  231. package/dist/redis/RedisRateLimitStore.d.ts +77 -0
  232. package/dist/redis/RedisSessionStore.d.ts +61 -0
  233. package/dist/redis/client.d.ts +41 -0
  234. package/dist/redis/index.d.ts +14 -356
  235. package/dist/redis/index.js +5 -2
  236. package/dist/redis/scan-keys.d.ts +6 -0
  237. package/dist/runtime/index.d.ts +8 -95
  238. package/dist/runtime/index.js +1 -1
  239. package/dist/scheduling/CronParser.d.ts +37 -0
  240. package/dist/scheduling/Schedule.d.ts +229 -0
  241. package/dist/scheduling/ScheduledTask.d.ts +47 -0
  242. package/dist/scheduling/Scheduler.d.ts +99 -0
  243. package/dist/scheduling/index.d.ts +5 -41
  244. package/dist/scheduling/types.d.ts +97 -0
  245. package/dist/storage/StorageManager.d.ts +65 -0
  246. package/dist/storage/drivers/LocalDriver.d.ts +55 -0
  247. package/dist/storage/drivers/MemoryDriver.d.ts +66 -0
  248. package/dist/storage/drivers/S3Driver.d.ts +72 -0
  249. package/dist/storage/index.d.ts +5 -197
  250. package/dist/{StorageManager-oZTHqaza.d.ts → storage/types.d.ts} +10 -77
  251. package/dist/support/error-polyfill.d.ts +9 -0
  252. package/dist/support/import-map.d.ts +13 -0
  253. package/dist/support/redirect-target.d.ts +11 -0
  254. package/dist/support/stack-frames.d.ts +56 -0
  255. package/dist/support/trim-slashes.d.ts +11 -0
  256. package/dist/vite/index.d.ts +2 -35
  257. package/dist/vite/index.js +0 -3
  258. package/dist/vite/plugin.d.ts +34 -0
  259. package/package.json +3 -3
  260. package/dist/AuthManager-DBP4KYsx.d.ts +0 -79
  261. package/dist/BroadcastManager-D8KoJxiV.d.ts +0 -492
  262. package/dist/HealthManager-DUyMIzsZ.d.ts +0 -141
  263. package/dist/I18nManager-BiSoczfV.d.ts +0 -275
  264. package/dist/LogManager-7mxnkaPM.d.ts +0 -256
  265. package/dist/Scheduler-pZiT8i57.d.ts +0 -471
  266. package/dist/api-token-D24VPr_E.d.ts +0 -663
  267. package/dist/app-key-CsBfRC_Q.d.ts +0 -214
  268. package/dist/email-verification-Dx426KLn.d.ts +0 -336
  269. package/dist/index-9_Jzj5jo.d.ts +0 -7
  270. package/dist/validation-yAL53e1S.d.ts +0 -2610
@@ -1,233 +1,6 @@
1
- import { B as BroadcastManager, P as PresenceBroadcastDriver, c as BroadcastEvent, j as PresenceMember } from '../BroadcastManager-D8KoJxiV.js';
2
- export { A as AuthMiddlewareOptions, a as BroadcastDriver, b as BroadcastDriverFactory, d as BroadcastManagerOptions, e as BroadcastableEvent, C as Channel, f as ChannelAuthorizer, g as ChannelRegistration, h as PresenceChannel, i as PresenceChannelAuthorizer, k as PrivateChannel, S as SSEClient, l as SSEMiddlewareOptions, W as WebSocketClient, m as createBroadcastManager, n as getBroadcastManager, s as setBroadcastManager } from '../BroadcastManager-D8KoJxiV.js';
3
- import '../index-9_Jzj5jo.js';
4
- import 'hono';
5
-
6
- type ChannelEventsMap = Record<string, Record<string, unknown>>;
7
- type ChannelNameFor<TEvents extends ChannelEventsMap> = keyof TEvents & string;
8
- type EventNameFor<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>> = keyof TEvents[TChannel] & string;
9
- type PayloadFor<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>, TEvent extends EventNameFor<TEvents, TChannel>> = TEvents[TChannel][TEvent];
10
- interface TypedChannelHandle<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>> {
11
- readonly name: TChannel;
12
- broadcast<TEvent extends EventNameFor<TEvents, TChannel>>(event: TEvent, payload: PayloadFor<TEvents, TChannel, TEvent>): Promise<void>;
13
- }
14
- interface TypedPrivateChannelHandle<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>> extends TypedChannelHandle<TEvents, TChannel> {
15
- readonly name: TChannel;
16
- }
17
- interface TypedPresenceChannelHandle<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>> extends TypedChannelHandle<TEvents, TChannel> {
18
- readonly name: TChannel;
19
- }
20
- interface TypedBroadcaster<TEvents extends ChannelEventsMap> {
21
- broadcast<TChannel extends ChannelNameFor<TEvents>, TEvent extends EventNameFor<TEvents, TChannel>>(channel: TChannel, event: TEvent, payload: PayloadFor<TEvents, TChannel, TEvent>): Promise<void>;
22
- toChannel<TChannel extends ChannelNameFor<TEvents>>(channel: TChannel): TypedChannelHandle<TEvents, TChannel>;
23
- toPrivate<TChannel extends ChannelNameFor<TEvents>>(channel: TChannel): TypedPrivateChannelHandle<TEvents, TChannel>;
24
- toPresence<TChannel extends ChannelNameFor<TEvents>>(channel: TChannel): TypedPresenceChannelHandle<TEvents, TChannel>;
25
- }
26
- declare function createTypedBroadcaster<TEvents extends ChannelEventsMap>(manager: BroadcastManager): TypedBroadcaster<TEvents>;
27
-
28
- /**
29
- * Memory broadcast driver.
30
- *
31
- * Stores all subscriptions and presence data in memory.
32
- * Useful for testing and single-server deployments.
33
- *
34
- * @example
35
- * ```typescript
36
- * const driver = new MemoryDriver()
37
- *
38
- * // Subscribe to a channel
39
- * const unsubscribe = driver.subscribe('notifications', (event) => {
40
- * console.log('Received:', event)
41
- * })
42
- *
43
- * // Publish an event
44
- * await driver.publish('notifications', 'NewMessage', { content: 'Hello!' })
45
- *
46
- * // Unsubscribe
47
- * unsubscribe()
48
- * ```
49
- */
50
- declare class MemoryDriver implements PresenceBroadcastDriver {
51
- /**
52
- * Channel subscribers.
53
- */
54
- protected subscribers: Map<string, Set<(event: BroadcastEvent) => void>>;
55
- /**
56
- * Presence channel members.
57
- */
58
- protected presenceMembers: Map<string, Map<string | number, PresenceMember>>;
59
- /**
60
- * Published events (for testing).
61
- */
62
- protected publishedEvents: BroadcastEvent[];
63
- /**
64
- * Publish an event to a channel.
65
- */
66
- publish(channel: string, event: string, data: unknown): Promise<void>;
67
- /**
68
- * Subscribe to a channel.
69
- */
70
- subscribe(channel: string, callback: (event: BroadcastEvent) => void): () => void;
71
- /**
72
- * Unsubscribe from a channel.
73
- */
74
- unsubscribe(channel: string, callback: (event: BroadcastEvent) => void): void;
75
- /**
76
- * Get members of a presence channel.
77
- */
78
- getMembers(channel: string): PresenceMember[];
79
- /**
80
- * Add a member to a presence channel.
81
- */
82
- addMember(channel: string, member: PresenceMember): void;
83
- /**
84
- * Remove a member from a presence channel.
85
- */
86
- removeMember(channel: string, memberId: string | number): void;
87
- /**
88
- * Check if a channel has subscribers.
89
- */
90
- hasSubscribers(channel: string): boolean;
91
- /**
92
- * Get subscriber count for a channel.
93
- */
94
- getSubscriberCount(channel: string): number;
95
- /**
96
- * Get all channels with subscribers.
97
- */
98
- getChannels(): string[];
99
- /**
100
- * Get all presence channels.
101
- */
102
- getPresenceChannels(): string[];
103
- /**
104
- * Get all published events (for testing).
105
- */
106
- getPublishedEvents(): BroadcastEvent[];
107
- /**
108
- * Get published events for a specific channel.
109
- */
110
- getPublishedEventsFor(channel: string): BroadcastEvent[];
111
- /**
112
- * Clear all data (for testing).
113
- */
114
- clear(): void;
115
- /**
116
- * Clear published events only.
117
- */
118
- clearPublishedEvents(): void;
119
- }
120
-
121
- /**
122
- * Redis client interface.
123
- * Compatible with ioredis and similar clients.
124
- */
125
- interface RedisClient {
126
- publish(channel: string, message: string): Promise<number>;
127
- subscribe(channel: string): Promise<void>;
128
- unsubscribe(channel: string): Promise<void>;
129
- on(event: 'message', callback: (channel: string, message: string) => void): void;
130
- hset(key: string, field: string, value: string): Promise<number>;
131
- hdel(key: string, field: string): Promise<number>;
132
- hgetall(key: string): Promise<Record<string, string>>;
133
- duplicate(): RedisClient;
134
- }
135
- /**
136
- * Redis broadcast driver.
137
- *
138
- * Uses Redis pub/sub for multi-server deployments.
139
- *
140
- * @example
141
- * ```typescript
142
- * import Redis from 'ioredis'
143
- *
144
- * const redis = new Redis()
145
- * const driver = new RedisDriver(redis)
146
- *
147
- * // Subscribe to a channel
148
- * driver.subscribe('notifications', (event) => {
149
- * console.log('Received:', event)
150
- * })
151
- *
152
- * // Publish an event
153
- * await driver.publish('notifications', 'NewMessage', { content: 'Hello!' })
154
- * ```
155
- */
156
- declare class RedisDriver implements PresenceBroadcastDriver {
157
- /**
158
- * Publisher Redis client.
159
- */
160
- protected publisher: RedisClient;
161
- /**
162
- * Subscriber Redis client.
163
- */
164
- protected subscriber: RedisClient;
165
- /**
166
- * Local subscribers.
167
- */
168
- protected subscribers: Map<string, Set<(event: BroadcastEvent) => void>>;
169
- /**
170
- * Local presence members cache.
171
- */
172
- protected localPresence: Map<string, Map<string | number, PresenceMember>>;
173
- /**
174
- * Presence key prefix.
175
- */
176
- protected presencePrefix: string;
177
- /**
178
- * Whether the driver is initialized.
179
- */
180
- protected initialized: boolean;
181
- constructor(redis: RedisClient, options?: RedisDriverOptions);
182
- /**
183
- * Setup the subscriber client.
184
- */
185
- protected setupSubscriber(): void;
186
- /**
187
- * Publish an event to a channel.
188
- */
189
- publish(channel: string, event: string, data: unknown): Promise<void>;
190
- /**
191
- * Subscribe to a channel.
192
- */
193
- subscribe(channel: string, callback: (event: BroadcastEvent) => void): () => void;
194
- /**
195
- * Unsubscribe from a channel.
196
- */
197
- unsubscribe(channel: string, callback: (event: BroadcastEvent) => void): void;
198
- /**
199
- * Get members of a presence channel.
200
- */
201
- getMembers(channel: string): PresenceMember[];
202
- /**
203
- * Get members asynchronously from Redis.
204
- */
205
- getMembersAsync(channel: string): Promise<PresenceMember[]>;
206
- /**
207
- * Add a member to a presence channel.
208
- */
209
- addMember(channel: string, member: PresenceMember): void;
210
- /**
211
- * Remove a member from a presence channel.
212
- */
213
- removeMember(channel: string, memberId: string | number): void;
214
- /**
215
- * Check if a channel has subscribers.
216
- */
217
- hasSubscribers(channel: string): boolean;
218
- /**
219
- * Get subscriber count for a channel.
220
- */
221
- getSubscriberCount(channel: string): number;
222
- }
223
- /**
224
- * Redis driver options.
225
- */
226
- interface RedisDriverOptions {
227
- /**
228
- * Prefix for presence keys.
229
- */
230
- presencePrefix?: string;
231
- }
232
-
233
- export { BroadcastEvent, BroadcastManager, MemoryDriver, PresenceBroadcastDriver, PresenceMember, type RedisClient, RedisDriver, type RedisDriverOptions, type TypedBroadcaster, type TypedChannelHandle, type TypedPresenceChannelHandle, type TypedPrivateChannelHandle, createTypedBroadcaster };
1
+ export type { BroadcastEvent, BroadcastDriver, PresenceBroadcastDriver, ChannelAuthorizer, PresenceChannelAuthorizer, PresenceMember, SSEClient, WebSocketClient, BroadcastManagerOptions, BroadcastDriverFactory, ChannelRegistration, SSEMiddlewareOptions, AuthMiddlewareOptions, BroadcastableEvent, } from './types.js';
2
+ export { BroadcastManager, setBroadcastManager, getBroadcastManager, createBroadcastManager, } from './BroadcastManager.js';
3
+ export { createTypedBroadcaster, } from './typed.js';
4
+ export type { TypedBroadcaster, TypedChannelHandle, TypedPrivateChannelHandle, TypedPresenceChannelHandle, } from './typed.js';
5
+ export { Channel, PrivateChannel, PresenceChannel } from './channels/index.js';
6
+ export { MemoryDriver, RedisDriver, type RedisClient, type RedisDriverOptions, } from './drivers/index.js';
@@ -9,7 +9,7 @@ import {
9
9
  createTypedBroadcaster,
10
10
  getBroadcastManager,
11
11
  setBroadcastManager
12
- } from "../chunk-TVY72CLV.js";
12
+ } from "../chunk-4VE3LYOM.js";
13
13
  import "../chunk-B5E5VBDI.js";
14
14
  export {
15
15
  BroadcastManager,
@@ -0,0 +1,23 @@
1
+ import type { BroadcastManager } from './BroadcastManager.js';
2
+ type ChannelEventsMap = Record<string, Record<string, unknown>>;
3
+ type ChannelNameFor<TEvents extends ChannelEventsMap> = keyof TEvents & string;
4
+ type EventNameFor<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>> = keyof TEvents[TChannel] & string;
5
+ type PayloadFor<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>, TEvent extends EventNameFor<TEvents, TChannel>> = TEvents[TChannel][TEvent];
6
+ export interface TypedChannelHandle<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>> {
7
+ readonly name: TChannel;
8
+ broadcast<TEvent extends EventNameFor<TEvents, TChannel>>(event: TEvent, payload: PayloadFor<TEvents, TChannel, TEvent>): Promise<void>;
9
+ }
10
+ export interface TypedPrivateChannelHandle<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>> extends TypedChannelHandle<TEvents, TChannel> {
11
+ readonly name: TChannel;
12
+ }
13
+ export interface TypedPresenceChannelHandle<TEvents extends ChannelEventsMap, TChannel extends ChannelNameFor<TEvents>> extends TypedChannelHandle<TEvents, TChannel> {
14
+ readonly name: TChannel;
15
+ }
16
+ export interface TypedBroadcaster<TEvents extends ChannelEventsMap> {
17
+ broadcast<TChannel extends ChannelNameFor<TEvents>, TEvent extends EventNameFor<TEvents, TChannel>>(channel: TChannel, event: TEvent, payload: PayloadFor<TEvents, TChannel, TEvent>): Promise<void>;
18
+ toChannel<TChannel extends ChannelNameFor<TEvents>>(channel: TChannel): TypedChannelHandle<TEvents, TChannel>;
19
+ toPrivate<TChannel extends ChannelNameFor<TEvents>>(channel: TChannel): TypedPrivateChannelHandle<TEvents, TChannel>;
20
+ toPresence<TChannel extends ChannelNameFor<TEvents>>(channel: TChannel): TypedPresenceChannelHandle<TEvents, TChannel>;
21
+ }
22
+ export declare function createTypedBroadcaster<TEvents extends ChannelEventsMap>(manager: BroadcastManager): TypedBroadcaster<TEvents>;
23
+ export {};
@@ -0,0 +1,155 @@
1
+ /**
2
+ * Broadcast event payload.
3
+ */
4
+ export interface BroadcastEvent {
5
+ channel: string;
6
+ event: string;
7
+ data: unknown;
8
+ timestamp: Date;
9
+ }
10
+ /**
11
+ * Broadcast driver interface.
12
+ */
13
+ export interface BroadcastDriver {
14
+ /**
15
+ * Publish an event to a channel.
16
+ */
17
+ publish(channel: string, event: string, data: unknown): Promise<void>;
18
+ /**
19
+ * Subscribe to a channel.
20
+ * Returns an unsubscribe function.
21
+ */
22
+ subscribe(channel: string, callback: (event: BroadcastEvent) => void): () => void;
23
+ /**
24
+ * Unsubscribe from a channel.
25
+ */
26
+ unsubscribe(channel: string, callback: (event: BroadcastEvent) => void): void;
27
+ }
28
+ /**
29
+ * Broadcast driver with presence support.
30
+ */
31
+ export interface PresenceBroadcastDriver extends BroadcastDriver {
32
+ /**
33
+ * Get members of a presence channel.
34
+ */
35
+ getMembers(channel: string): PresenceMember[];
36
+ /**
37
+ * Add a member to a presence channel.
38
+ */
39
+ addMember(channel: string, member: PresenceMember): void;
40
+ /**
41
+ * Remove a member from a presence channel.
42
+ */
43
+ removeMember(channel: string, memberId: string | number): void;
44
+ }
45
+ /**
46
+ * Channel authorizer function.
47
+ */
48
+ export interface ChannelAuthorizer {
49
+ (channelName: string, user: unknown): boolean | Promise<boolean>;
50
+ }
51
+ /**
52
+ * Presence channel authorizer function.
53
+ * Returns member info if authorized, null otherwise.
54
+ */
55
+ export interface PresenceChannelAuthorizer {
56
+ (channelName: string, user: unknown): PresenceMember | null | Promise<PresenceMember | null>;
57
+ }
58
+ /**
59
+ * Presence channel member.
60
+ */
61
+ export interface PresenceMember {
62
+ id: string | number;
63
+ info?: Record<string, unknown>;
64
+ }
65
+ /**
66
+ * SSE client connection.
67
+ */
68
+ export interface SSEClient {
69
+ id: string;
70
+ userId?: string | number;
71
+ channels: Set<string>;
72
+ send(event: string, data: unknown): void;
73
+ close(): void;
74
+ }
75
+ /**
76
+ * WebSocket client connection.
77
+ */
78
+ export interface WebSocketClient {
79
+ id: string;
80
+ userId?: string | number;
81
+ channels: Set<string>;
82
+ send(event: string, data: unknown): void | Promise<void>;
83
+ close(): void;
84
+ }
85
+ /**
86
+ * Broadcast manager options.
87
+ */
88
+ export interface BroadcastManagerOptions {
89
+ /**
90
+ * Default driver name.
91
+ */
92
+ default?: string;
93
+ /**
94
+ * Driver factories.
95
+ */
96
+ drivers?: Record<string, BroadcastDriverFactory>;
97
+ }
98
+ /**
99
+ * Broadcast driver factory.
100
+ */
101
+ export interface BroadcastDriverFactory {
102
+ (): BroadcastDriver;
103
+ }
104
+ /**
105
+ * Channel registration.
106
+ */
107
+ export interface ChannelRegistration {
108
+ pattern: string;
109
+ type: 'public' | 'private' | 'presence';
110
+ authorizer: ChannelAuthorizer | PresenceChannelAuthorizer;
111
+ }
112
+ /**
113
+ * SSE middleware options.
114
+ */
115
+ export interface SSEMiddlewareOptions {
116
+ /**
117
+ * Ping interval in milliseconds.
118
+ */
119
+ pingInterval?: number;
120
+ /**
121
+ * Retry delay for SSE reconnection.
122
+ */
123
+ retry?: number;
124
+ /**
125
+ * Function to get the user from the request context, used to authorize
126
+ * channels requested via the `?channels=` query parameter.
127
+ */
128
+ getUser?: (ctx: unknown) => unknown | Promise<unknown>;
129
+ }
130
+ /**
131
+ * Auth middleware options.
132
+ */
133
+ export interface AuthMiddlewareOptions {
134
+ /**
135
+ * Function to get user from context.
136
+ */
137
+ getUser?: (ctx: unknown) => unknown | Promise<unknown>;
138
+ }
139
+ /**
140
+ * Broadcasted event interface (for Event class integration).
141
+ */
142
+ export interface BroadcastableEvent {
143
+ /**
144
+ * Get channels to broadcast to.
145
+ */
146
+ broadcastOn(): string[];
147
+ /**
148
+ * Get the event name for broadcasting.
149
+ */
150
+ broadcastAs?(): string;
151
+ /**
152
+ * Get the data to broadcast.
153
+ */
154
+ broadcastWith?(): Record<string, unknown>;
155
+ }
@@ -0,0 +1,87 @@
1
+ import type { CacheStore, TaggableCacheStore, CacheStoreFactory, CacheConfig } from './types.js';
2
+ /**
3
+ * Cache manager for handling multiple cache stores.
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * const cache = new CacheManager({
8
+ * default: 'redis',
9
+ * stores: {
10
+ * memory: { driver: 'memory' },
11
+ * redis: { driver: 'redis', client: redisClient },
12
+ * file: { driver: 'file', path: './storage/cache' },
13
+ * }
14
+ * })
15
+ *
16
+ * // Use the default store
17
+ * await cache.store().set('key', 'value', 3600)
18
+ *
19
+ * // Use a specific store
20
+ * await cache.store('memory').set('key', 'value')
21
+ *
22
+ * // Use tagged cache
23
+ * await cache.store().tags(['posts', 'user:1']).set('user:1:posts', posts)
24
+ * await cache.store().tags(['user:1']).flush()
25
+ * ```
26
+ */
27
+ export declare class CacheManager {
28
+ private readonly defaultStoreName;
29
+ private readonly storeFactories;
30
+ private readonly resolvedStores;
31
+ /**
32
+ * Where this manager was built, for identifying its stores across hot reloads.
33
+ *
34
+ * Captured here rather than in `store()` because stores resolve lazily, from
35
+ * whichever request first asks for one — a call site that says nothing about
36
+ * which manager owns the result. Skipped outside `--hot`, where it would be a
37
+ * formatted stack string held for the manager's lifetime and never read.
38
+ */
39
+ private readonly builtAt;
40
+ constructor(config?: CacheConfig);
41
+ private driverFactories;
42
+ /**
43
+ * Register built-in store drivers.
44
+ */
45
+ private registerBuiltinDrivers;
46
+ /**
47
+ * Register a store from configuration.
48
+ */
49
+ private registerStoreFromConfig;
50
+ /**
51
+ * Get a cache store by name.
52
+ * Returns the default store if no name is specified.
53
+ */
54
+ store(name?: string): TaggableCacheStore;
55
+ /**
56
+ * Under `bun --hot`, stops the sweep timer held by the store this one replaces.
57
+ *
58
+ * Registered from here rather than from `MemoryStore` itself because this is
59
+ * where the store's name is known, and the name is what keeps two memory
60
+ * stores in one config from sharing a slot and cancelling each other's sweep.
61
+ */
62
+ private stopPreviousStore;
63
+ /**
64
+ * Register a custom store factory.
65
+ */
66
+ registerStore(name: string, factory: CacheStoreFactory): void;
67
+ /**
68
+ * Register a custom driver.
69
+ */
70
+ registerDriver(name: string, factory: (options: unknown) => CacheStore): void;
71
+ /**
72
+ * Check if a store is registered.
73
+ */
74
+ hasStore(name: string): boolean;
75
+ /**
76
+ * Get the default store name.
77
+ */
78
+ getDefaultStoreName(): string;
79
+ /**
80
+ * Get all registered store names.
81
+ */
82
+ getStoreNames(): string[];
83
+ }
84
+ /**
85
+ * Create a cache manager with configuration.
86
+ */
87
+ export declare function createCacheManager(config?: CacheConfig): CacheManager;
@@ -0,0 +1,62 @@
1
+ import type { CacheStore, TaggedCacheStore } from './types.js';
2
+ /**
3
+ * Tagged cache implementation.
4
+ * Allows grouping cache items by tags for bulk invalidation.
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * const tagged = new TaggedCache(store, ['posts', 'user:1'])
9
+ *
10
+ * await tagged.set('user:1:posts', posts, 3600)
11
+ * await tagged.flush() // Removes all items with these tags
12
+ * ```
13
+ */
14
+ export declare class TaggedCache implements TaggedCacheStore {
15
+ private readonly store;
16
+ private readonly tags;
17
+ private readonly tagSetPrefix;
18
+ constructor(store: CacheStore, tags: string[], tagSetPrefix?: string);
19
+ /**
20
+ * Get a unique namespace for the current tags.
21
+ */
22
+ private getTagNamespace;
23
+ /**
24
+ * Generate a unique namespace identifier.
25
+ */
26
+ private generateNamespace;
27
+ /**
28
+ * Get the tagged key.
29
+ */
30
+ private taggedKey;
31
+ /**
32
+ * Track a key in the tag sets.
33
+ */
34
+ private trackKey;
35
+ get<T>(key: string): Promise<T | null>;
36
+ set<T>(key: string, value: T, ttl?: number): Promise<void>;
37
+ has(key: string): Promise<boolean>;
38
+ delete(key: string): Promise<boolean>;
39
+ clear(): Promise<void>;
40
+ increment(key: string, value?: number): Promise<number>;
41
+ decrement(key: string, value?: number): Promise<number>;
42
+ remember<T>(key: string, ttl: number, callback: () => Promise<T>): Promise<T>;
43
+ rememberForever<T>(key: string, callback: () => Promise<T>): Promise<T>;
44
+ getMany<T>(keys: string[]): Promise<Map<string, T | null>>;
45
+ setMany<T>(items: Map<string, T>, ttl?: number): Promise<void>;
46
+ deleteMany(keys: string[]): Promise<number>;
47
+ ttl(key: string): Promise<number>;
48
+ /**
49
+ * Flush all items with the current tags.
50
+ * This works by resetting the tag namespaces, effectively
51
+ * making all previously tagged items inaccessible.
52
+ */
53
+ flush(): Promise<void>;
54
+ /**
55
+ * Get the current tags.
56
+ */
57
+ getTags(): string[];
58
+ /**
59
+ * Get the underlying store.
60
+ */
61
+ getStore(): CacheStore;
62
+ }