@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
@@ -0,0 +1,229 @@
1
+ import type { TaskCallback, TaskDefinition, JobClass } from './types.js';
2
+ import { ScheduledTask } from './ScheduledTask.js';
3
+ /**
4
+ * Pending schedule builder for fluent API.
5
+ */
6
+ export declare class PendingSchedule {
7
+ private readonly callback;
8
+ private expression;
9
+ private timezone?;
10
+ private taskName?;
11
+ private withoutOverlapping;
12
+ private overlapExpiresAt?;
13
+ private onOneServer;
14
+ private whenCallback?;
15
+ private skipCallback?;
16
+ private beforeCallback?;
17
+ private afterCallback?;
18
+ private successCallback?;
19
+ private failureCallback?;
20
+ constructor(callback: TaskCallback);
21
+ /**
22
+ * Run every minute.
23
+ */
24
+ everyMinute(): this;
25
+ /**
26
+ * Run every two minutes.
27
+ */
28
+ everyTwoMinutes(): this;
29
+ /**
30
+ * Run every three minutes.
31
+ */
32
+ everyThreeMinutes(): this;
33
+ /**
34
+ * Run every four minutes.
35
+ */
36
+ everyFourMinutes(): this;
37
+ /**
38
+ * Run every five minutes.
39
+ */
40
+ everyFiveMinutes(): this;
41
+ /**
42
+ * Run every ten minutes.
43
+ */
44
+ everyTenMinutes(): this;
45
+ /**
46
+ * Run every fifteen minutes.
47
+ */
48
+ everyFifteenMinutes(): this;
49
+ /**
50
+ * Run every thirty minutes.
51
+ */
52
+ everyThirtyMinutes(): this;
53
+ /**
54
+ * Run hourly.
55
+ */
56
+ hourly(): this;
57
+ /**
58
+ * Run hourly at a specific minute.
59
+ */
60
+ hourlyAt(minute: number): this;
61
+ /**
62
+ * Run every two hours.
63
+ */
64
+ everyTwoHours(): this;
65
+ /**
66
+ * Run every three hours.
67
+ */
68
+ everyThreeHours(): this;
69
+ /**
70
+ * Run every four hours.
71
+ */
72
+ everyFourHours(): this;
73
+ /**
74
+ * Run every six hours.
75
+ */
76
+ everySixHours(): this;
77
+ /**
78
+ * Run daily at midnight.
79
+ */
80
+ daily(): this;
81
+ /**
82
+ * Run daily at a specific time.
83
+ * @param time Time in HH:MM format
84
+ */
85
+ dailyAt(time: string): this;
86
+ /**
87
+ * Alias for dailyAt.
88
+ */
89
+ at(time: string): this;
90
+ /**
91
+ * Run twice daily.
92
+ */
93
+ twiceDaily(firstHour?: number, secondHour?: number): this;
94
+ /**
95
+ * Run weekly on Sunday at midnight.
96
+ */
97
+ weekly(): this;
98
+ /**
99
+ * Run weekly on a specific day at a specific time.
100
+ * @param day Day of week (0 = Sunday, 6 = Saturday)
101
+ * @param time Time in HH:MM format
102
+ */
103
+ weeklyOn(day: number, time?: string): this;
104
+ sundays(): this;
105
+ mondays(): this;
106
+ tuesdays(): this;
107
+ wednesdays(): this;
108
+ thursdays(): this;
109
+ fridays(): this;
110
+ saturdays(): this;
111
+ /**
112
+ * Run on weekdays (Monday-Friday).
113
+ */
114
+ weekdays(): this;
115
+ /**
116
+ * Run on weekends (Saturday-Sunday).
117
+ */
118
+ weekends(): this;
119
+ /**
120
+ * Run monthly on the first day at midnight.
121
+ */
122
+ monthly(): this;
123
+ /**
124
+ * Run monthly on a specific day at a specific time.
125
+ */
126
+ monthlyOn(day: number, time?: string): this;
127
+ /**
128
+ * Run on the last day of the month.
129
+ */
130
+ lastDayOfMonth(time?: string): this;
131
+ /**
132
+ * Run quarterly.
133
+ */
134
+ quarterly(): this;
135
+ /**
136
+ * Run yearly on January 1st at midnight.
137
+ */
138
+ yearly(): this;
139
+ /**
140
+ * Run yearly on a specific date.
141
+ */
142
+ yearlyOn(month: number, day: number, time?: string): this;
143
+ /**
144
+ * Set a custom cron expression.
145
+ */
146
+ cron(expression: string): this;
147
+ /**
148
+ * Set the task name.
149
+ */
150
+ name(name: string): this;
151
+ /**
152
+ * Set the timezone.
153
+ */
154
+ tz(timezone: string): this;
155
+ /**
156
+ * Alias for tz().
157
+ */
158
+ setTimezone(timezone: string): this;
159
+ /**
160
+ * Prevent overlapping executions.
161
+ */
162
+ preventOverlapping(expiresAt?: number): this;
163
+ /**
164
+ * Alias for preventOverlapping().
165
+ */
166
+ withoutOverlaps(expiresAt?: number): this;
167
+ /**
168
+ * Only run on one server.
169
+ */
170
+ runOnOneServer(): this;
171
+ /**
172
+ * Set a condition for running.
173
+ */
174
+ when(callback: () => boolean | Promise<boolean>): this;
175
+ /**
176
+ * Set a condition to skip execution.
177
+ */
178
+ skip(callback: () => boolean | Promise<boolean>): this;
179
+ /**
180
+ * Set a before callback.
181
+ */
182
+ before(callback: () => void | Promise<void>): this;
183
+ /**
184
+ * Set an after callback.
185
+ */
186
+ after(callback: () => void | Promise<void>): this;
187
+ /**
188
+ * Set a success callback.
189
+ */
190
+ onSuccess(callback: () => void | Promise<void>): this;
191
+ /**
192
+ * Set a failure callback.
193
+ */
194
+ onFailure(callback: (error: Error) => void | Promise<void>): this;
195
+ /**
196
+ * Build the task definition.
197
+ */
198
+ build(): TaskDefinition;
199
+ /**
200
+ * Build as a ScheduledTask.
201
+ */
202
+ toTask(): ScheduledTask;
203
+ }
204
+ /**
205
+ * Schedule builder for defining multiple tasks.
206
+ */
207
+ export declare class Schedule {
208
+ private readonly tasks;
209
+ /**
210
+ * Schedule a callback.
211
+ */
212
+ call(callback: TaskCallback): PendingSchedule;
213
+ /**
214
+ * Schedule a job.
215
+ */
216
+ job<T>(jobClass: JobClass<T>, payload: T): PendingSchedule;
217
+ /**
218
+ * Schedule a shell command.
219
+ */
220
+ command(cmd: string): PendingSchedule;
221
+ /**
222
+ * Get all pending schedules.
223
+ */
224
+ getPendingSchedules(): PendingSchedule[];
225
+ /**
226
+ * Build all tasks.
227
+ */
228
+ buildTasks(): ScheduledTask[];
229
+ }
@@ -0,0 +1,47 @@
1
+ import type { TaskDefinition } from './types.js';
2
+ /**
3
+ * Represents a scheduled task.
4
+ */
5
+ export declare class ScheduledTask {
6
+ private readonly definition;
7
+ private lastRun;
8
+ private isRunning;
9
+ constructor(definition: TaskDefinition);
10
+ /**
11
+ * Get the task name.
12
+ */
13
+ getName(): string;
14
+ /**
15
+ * Get the cron expression.
16
+ */
17
+ getExpression(): string;
18
+ /**
19
+ * Get the timezone.
20
+ */
21
+ getTimezone(): string | undefined;
22
+ /**
23
+ * Check if the task is due.
24
+ */
25
+ isDue(date?: Date): boolean;
26
+ /**
27
+ * Check if the task should run based on conditions.
28
+ * Note: Overlap checking is handled separately in run() to prevent race conditions.
29
+ */
30
+ shouldRun(): Promise<boolean>;
31
+ /**
32
+ * Run the task.
33
+ */
34
+ run(): Promise<void>;
35
+ /**
36
+ * Get the last run time.
37
+ */
38
+ getLastRun(): Date | null;
39
+ /**
40
+ * Check if the task is currently running.
41
+ */
42
+ isCurrentlyRunning(): boolean;
43
+ /**
44
+ * Get the task definition.
45
+ */
46
+ getDefinition(): TaskDefinition;
47
+ }
@@ -0,0 +1,99 @@
1
+ import type { SchedulerOptions } from './types.js';
2
+ import { Schedule } from './Schedule.js';
3
+ import { ScheduledTask } from './ScheduledTask.js';
4
+ /**
5
+ * Task scheduler for running periodic tasks.
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * const scheduler = new Scheduler()
10
+ *
11
+ * scheduler.schedule((schedule) => {
12
+ * schedule.call(async () => {
13
+ * await cleanupOldSessions()
14
+ * }).daily().at('03:00').name('cleanup-sessions')
15
+ *
16
+ * schedule.job(SendWeeklyDigestJob, {})
17
+ * .weekly()
18
+ * .sundays()
19
+ * .at('09:00')
20
+ * .tz('Asia/Tokyo')
21
+ * })
22
+ *
23
+ * scheduler.start()
24
+ * ```
25
+ */
26
+ export declare class Scheduler {
27
+ private tasks;
28
+ private readonly options;
29
+ private interval;
30
+ private isRunning;
31
+ private lastCheck;
32
+ /** This scheduler's claim on its hot-reload slot while it is running. */
33
+ private hotReloadClaim;
34
+ constructor(options?: SchedulerOptions);
35
+ /**
36
+ * Define schedules using a callback.
37
+ */
38
+ schedule(definer: (schedule: Schedule) => void): void;
39
+ /**
40
+ * Add a pre-built task.
41
+ */
42
+ addTask(task: ScheduledTask): void;
43
+ /**
44
+ * Get all scheduled tasks.
45
+ */
46
+ getTasks(): ScheduledTask[];
47
+ /**
48
+ * Get tasks that are due now.
49
+ */
50
+ getDueTasks(date?: Date): ScheduledTask[];
51
+ /**
52
+ * Run all due tasks.
53
+ */
54
+ runDueTasks(date?: Date): Promise<void>;
55
+ /**
56
+ * Start the scheduler.
57
+ */
58
+ start(): void;
59
+ /**
60
+ * Stop the scheduler.
61
+ */
62
+ stop(): void;
63
+ /**
64
+ * Check and run due tasks.
65
+ */
66
+ private tick;
67
+ /**
68
+ * Check if the scheduler is running.
69
+ */
70
+ getIsRunning(): boolean;
71
+ /**
72
+ * Get the check interval.
73
+ */
74
+ getCheckInterval(): number;
75
+ /**
76
+ * Get the default timezone.
77
+ */
78
+ getTimezone(): string;
79
+ /**
80
+ * Clear all tasks.
81
+ */
82
+ clear(): void;
83
+ /**
84
+ * Get the number of tasks.
85
+ */
86
+ count(): number;
87
+ /**
88
+ * Get task by name.
89
+ */
90
+ getTask(name: string): ScheduledTask | undefined;
91
+ /**
92
+ * Remove a task by name.
93
+ */
94
+ removeTask(name: string): boolean;
95
+ }
96
+ /**
97
+ * Create a scheduler instance.
98
+ */
99
+ export declare function createScheduler(options?: SchedulerOptions): Scheduler;
@@ -1,41 +1,5 @@
1
- import { P as ParsedCron } from '../Scheduler-pZiT8i57.js';
2
- export { J as JobClass, a as PendingSchedule, b as Schedule, c as ScheduledTask, S as Scheduler, d as SchedulerOptions, T as TaskCallback, e as TaskDefinition, f as createScheduler } from '../Scheduler-pZiT8i57.js';
3
-
4
- /**
5
- * Parse a cron expression.
6
- *
7
- * Cron format: minute hour dayOfMonth month dayOfWeek
8
- *
9
- * Examples:
10
- * - Every minute: "* * * * *"
11
- * - Every 5 minutes: "*​/5 * * * *" (step value)
12
- * - At 3:00 AM daily: "0 3 * * *"
13
- * - Every Monday at 9:00 AM: "0 9 * * 1"
14
- */
15
- declare function parseCron(expression: string): ParsedCron;
16
- /**
17
- * Check if a date matches a parsed cron expression.
18
- */
19
- declare function matchesCron(date: Date, cron: ParsedCron): boolean;
20
- /**
21
- * Get the next occurrence of a cron expression.
22
- */
23
- declare function getNextOccurrence(expression: string, from?: Date): Date;
24
- /**
25
- * Check if a cron expression is due at the given date.
26
- */
27
- declare function isDue(expression: string, date?: Date): boolean;
28
- /**
29
- * Get multiple next occurrences.
30
- */
31
- declare function getNextOccurrences(expression: string, count: number, from?: Date): Date[];
32
- /**
33
- * Convert a Date to a specific timezone.
34
- */
35
- declare function toTimezone(date: Date, timezone: string): Date;
36
- /**
37
- * Check if a cron expression is due in a specific timezone.
38
- */
39
- declare function isDueInTimezone(expression: string, timezone: string, date?: Date): boolean;
40
-
41
- export { ParsedCron, getNextOccurrence, getNextOccurrences, isDue, isDueInTimezone, matchesCron, parseCron, toTimezone };
1
+ export type { TaskCallback, TaskDefinition, SchedulerOptions, ParsedCron, JobClass, } from './types.js';
2
+ export { parseCron, matchesCron, getNextOccurrence, getNextOccurrences, isDue, isDueInTimezone, toTimezone, } from './CronParser.js';
3
+ export { ScheduledTask } from './ScheduledTask.js';
4
+ export { PendingSchedule, Schedule } from './Schedule.js';
5
+ export { Scheduler, createScheduler } from './Scheduler.js';
@@ -0,0 +1,97 @@
1
+ /**
2
+ * Scheduled task callback.
3
+ */
4
+ export type TaskCallback = () => void | Promise<void>;
5
+ /**
6
+ * Task definition.
7
+ */
8
+ export interface TaskDefinition {
9
+ /**
10
+ * Task name.
11
+ */
12
+ name?: string;
13
+ /**
14
+ * Cron expression.
15
+ */
16
+ expression: string;
17
+ /**
18
+ * Timezone for the schedule.
19
+ */
20
+ timezone?: string;
21
+ /**
22
+ * Task callback.
23
+ */
24
+ callback: TaskCallback;
25
+ /**
26
+ * Prevent overlapping executions.
27
+ */
28
+ withoutOverlapping?: boolean;
29
+ /**
30
+ * Overlap expiration in milliseconds.
31
+ */
32
+ overlapExpiresAt?: number;
33
+ /**
34
+ * Only run on one server (requires distributed lock).
35
+ */
36
+ onOneServer?: boolean;
37
+ /**
38
+ * Condition callback to determine if task should run.
39
+ */
40
+ when?: () => boolean | Promise<boolean>;
41
+ /**
42
+ * Condition callback to skip execution.
43
+ */
44
+ skip?: () => boolean | Promise<boolean>;
45
+ /**
46
+ * Before execution callback.
47
+ */
48
+ before?: () => void | Promise<void>;
49
+ /**
50
+ * After execution callback.
51
+ */
52
+ after?: () => void | Promise<void>;
53
+ /**
54
+ * On success callback.
55
+ */
56
+ onSuccess?: () => void | Promise<void>;
57
+ /**
58
+ * On failure callback.
59
+ */
60
+ onFailure?: (error: Error) => void | Promise<void>;
61
+ }
62
+ /**
63
+ * Scheduler options.
64
+ */
65
+ export interface SchedulerOptions {
66
+ /**
67
+ * Timezone for all scheduled tasks.
68
+ * @default 'UTC'
69
+ */
70
+ timezone?: string;
71
+ /**
72
+ * Check interval in milliseconds.
73
+ * @default 60000 (1 minute)
74
+ */
75
+ checkInterval?: number;
76
+ /**
77
+ * Logger function.
78
+ */
79
+ logger?: (message: string) => void;
80
+ }
81
+ /**
82
+ * Parsed cron expression.
83
+ */
84
+ export interface ParsedCron {
85
+ minute: number[];
86
+ hour: number[];
87
+ dayOfMonth: number[];
88
+ month: number[];
89
+ dayOfWeek: number[];
90
+ }
91
+ /**
92
+ * Job class interface for scheduling.
93
+ */
94
+ export interface JobClass<T = unknown> {
95
+ dispatch(payload: T): Promise<void>;
96
+ dispatchAfter?(delayMs: number, payload: T): Promise<void>;
97
+ }
@@ -0,0 +1,65 @@
1
+ import type { StorageDriver, StorageDriverFactory, StorageConfig } from './types.js';
2
+ /**
3
+ * Storage manager for handling multiple storage disks.
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * const storage = new StorageManager({
8
+ * default: 'local',
9
+ * disks: {
10
+ * local: { driver: 'local', root: './storage/app' },
11
+ * s3: { driver: 's3', bucket: 'my-bucket', region: 'ap-northeast-1' },
12
+ * }
13
+ * })
14
+ *
15
+ * // Use the default disk
16
+ * await storage.disk().put('avatars/user-1.jpg', imageBuffer)
17
+ *
18
+ * // Use a specific disk
19
+ * await storage.disk('s3').put('avatars/user-1.jpg', imageBuffer)
20
+ * ```
21
+ */
22
+ export declare class StorageManager {
23
+ private readonly defaultDiskName;
24
+ private readonly diskFactories;
25
+ private readonly resolvedDisks;
26
+ private driverFactories;
27
+ constructor(config?: StorageConfig);
28
+ /**
29
+ * Register built-in disk drivers.
30
+ */
31
+ private registerBuiltinDrivers;
32
+ /**
33
+ * Register a disk from configuration.
34
+ */
35
+ private registerDiskFromConfig;
36
+ /**
37
+ * Get a storage disk by name.
38
+ * Returns the default disk if no name is specified.
39
+ */
40
+ disk(name?: string): StorageDriver;
41
+ /**
42
+ * Register a custom disk factory.
43
+ */
44
+ registerDisk(name: string, factory: StorageDriverFactory): void;
45
+ /**
46
+ * Register a custom driver.
47
+ */
48
+ registerDriver(name: string, factory: (options: unknown) => StorageDriver): void;
49
+ /**
50
+ * Check if a disk is registered.
51
+ */
52
+ hasDisk(name: string): boolean;
53
+ /**
54
+ * Get the default disk name.
55
+ */
56
+ getDefaultDiskName(): string;
57
+ /**
58
+ * Get all registered disk names.
59
+ */
60
+ getDiskNames(): string[];
61
+ }
62
+ /**
63
+ * Create a storage manager with configuration.
64
+ */
65
+ export declare function createStorageManager(config?: StorageConfig): StorageManager;
@@ -0,0 +1,55 @@
1
+ import type { StorageDriver, LocalDriverOptions, PutOptions, FileMetadata } from '../types.js';
2
+ /**
3
+ * Local filesystem storage driver.
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * const driver = new LocalDriver({
8
+ * root: './storage/app',
9
+ * url: '/storage',
10
+ * })
11
+ *
12
+ * await driver.put('avatars/user-1.jpg', imageBuffer)
13
+ * const url = driver.url('avatars/user-1.jpg')
14
+ * ```
15
+ */
16
+ export declare class LocalDriver implements StorageDriver {
17
+ private readonly root;
18
+ private readonly baseUrl;
19
+ private readonly defaultVisibility;
20
+ constructor(options: LocalDriverOptions);
21
+ /**
22
+ * Get the full path for a file.
23
+ * Rejects paths that resolve outside the storage root (e.g. via `../`).
24
+ */
25
+ private fullPath;
26
+ /**
27
+ * Ensure the directory exists.
28
+ */
29
+ private ensureDirectory;
30
+ put(path: string, content: Buffer | string, options?: PutOptions): Promise<string>;
31
+ putFile(path: string, localPath: string, options?: PutOptions): Promise<string>;
32
+ get(path: string): Promise<Buffer | null>;
33
+ getAsString(path: string): Promise<string | null>;
34
+ exists(path: string): Promise<boolean>;
35
+ delete(path: string): Promise<boolean>;
36
+ deleteMany(paths: string[]): Promise<number>;
37
+ copy(from: string, to: string): Promise<string>;
38
+ move(from: string, to: string): Promise<string>;
39
+ url(path: string): string;
40
+ temporaryUrl(path: string, expiration: Date): Promise<string>;
41
+ size(path: string): Promise<number>;
42
+ lastModified(path: string): Promise<Date>;
43
+ metadata(path: string): Promise<FileMetadata | null>;
44
+ files(directory: string): Promise<string[]>;
45
+ directories(directory: string): Promise<string[]>;
46
+ allFiles(directory: string): Promise<string[]>;
47
+ makeDirectory(path: string): Promise<void>;
48
+ deleteDirectory(path: string): Promise<void>;
49
+ setVisibility(path: string, visibility: 'public' | 'private'): Promise<void>;
50
+ getVisibility(path: string): Promise<'public' | 'private'>;
51
+ /**
52
+ * Get the root directory.
53
+ */
54
+ getRoot(): string;
55
+ }
@@ -0,0 +1,66 @@
1
+ import type { StorageDriver, MemoryDriverOptions, PutOptions, FileMetadata } from '../types.js';
2
+ /**
3
+ * In-memory storage driver for testing.
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * const driver = new MemoryDriver()
8
+ *
9
+ * await driver.put('avatars/user-1.jpg', imageBuffer)
10
+ * const content = await driver.get('avatars/user-1.jpg')
11
+ * ```
12
+ */
13
+ export declare class MemoryDriver implements StorageDriver {
14
+ private readonly storage;
15
+ private readonly baseUrl;
16
+ constructor(options?: MemoryDriverOptions);
17
+ /**
18
+ * Normalize path (remove leading/trailing slashes).
19
+ */
20
+ private normalizePath;
21
+ /**
22
+ * Get directory from path.
23
+ */
24
+ private getDirectory;
25
+ /**
26
+ * Check if a path is in a directory.
27
+ */
28
+ private isInDirectory;
29
+ /**
30
+ * Check if a path is under a directory (recursive).
31
+ */
32
+ private isUnderDirectory;
33
+ put(path: string, content: Buffer | string, options?: PutOptions): Promise<string>;
34
+ putFile(path: string, localPath: string, options?: PutOptions): Promise<string>;
35
+ get(path: string): Promise<Buffer | null>;
36
+ getAsString(path: string): Promise<string | null>;
37
+ exists(path: string): Promise<boolean>;
38
+ delete(path: string): Promise<boolean>;
39
+ deleteMany(paths: string[]): Promise<number>;
40
+ copy(from: string, to: string): Promise<string>;
41
+ move(from: string, to: string): Promise<string>;
42
+ url(path: string): string;
43
+ temporaryUrl(path: string, expiration: Date): Promise<string>;
44
+ size(path: string): Promise<number>;
45
+ lastModified(path: string): Promise<Date>;
46
+ metadata(path: string): Promise<FileMetadata | null>;
47
+ files(directory: string): Promise<string[]>;
48
+ directories(directory: string): Promise<string[]>;
49
+ allFiles(directory: string): Promise<string[]>;
50
+ makeDirectory(path: string): Promise<void>;
51
+ deleteDirectory(path: string): Promise<void>;
52
+ setVisibility(path: string, visibility: 'public' | 'private'): Promise<void>;
53
+ getVisibility(path: string): Promise<'public' | 'private'>;
54
+ /**
55
+ * Clear all files (for testing).
56
+ */
57
+ clear(): void;
58
+ /**
59
+ * Get the number of stored files.
60
+ */
61
+ count(): number;
62
+ /**
63
+ * Get all stored file paths.
64
+ */
65
+ getAllPaths(): string[];
66
+ }