@guren/server 2.14.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 (297) hide show
  1. package/dist/{DocsViewerServiceProvider-qFCaeiUv.js → DocsViewerServiceProvider-D2cuVgtN.js} +7 -12
  2. package/dist/{Hash-CzrwKeDp.js → Hash-D2DFd8xX.js} +12 -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 +31 -0
  8. package/dist/agent/approval.d.ts +184 -0
  9. package/dist/agent/audit-emitter.d.ts +36 -0
  10. package/dist/agent/audit.d.ts +67 -0
  11. package/dist/agent/derive.d.ts +32 -66
  12. package/dist/agent/dispatch.d.ts +53 -63
  13. package/dist/agent/events.d.ts +11 -19
  14. package/dist/agent/meta-tools.d.ts +34 -0
  15. package/dist/agent/public.d.ts +14 -0
  16. package/dist/agent/public.js +2 -0
  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 +9 -5
  29. package/dist/auth/password/PasswordHasher.d.ts +7 -0
  30. package/dist/auth/password/hash-format.d.ts +11 -0
  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-BSUc14CD.js → auth-CbdPH4Cd.js} +252 -496
  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-BxU-LIfF.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 +10 -12
  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-BAwzftws.js +238 -0
  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-DJtkkhiw.js → encryption-uwP3Di4D.js} +13 -79
  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 +16 -18
  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 +14 -0
  148. package/dist/http/request.d.ts +49 -48
  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 +21 -0
  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 +13 -4
  170. package/dist/index.js +1036 -3080
  171. package/dist/internal/agent-preflight.d.ts +9 -21
  172. package/dist/internal/request.d.ts +10 -17
  173. package/dist/internal/request.js +2 -2
  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 -5
  187. package/dist/logging/channels/FileChannel.d.ts +1 -3
  188. package/dist/logging/daily-file-path.d.ts +15 -0
  189. package/dist/logging/index.d.ts +1 -0
  190. package/dist/logging/index.js +2 -2
  191. package/dist/logging/types.d.ts +13 -45
  192. package/dist/{logging-CPaRMuPP.js → logging-zOY1XCtq.js} +83 -129
  193. package/dist/{loopback-guard-D0Kc7-xc.js → loopback-guard-DT9gHF0F.js} +41 -92
  194. package/dist/mail/Mail.d.ts +10 -106
  195. package/dist/mail/MailManager.d.ts +2 -60
  196. package/dist/mail/index.js +1 -1
  197. package/dist/mail/transports/LogTransport.d.ts +1 -4
  198. package/dist/mail/transports/MemoryTransport.d.ts +1 -63
  199. package/dist/mail/transports/ResendTransport.d.ts +1 -23
  200. package/dist/mail/transports/SmtpTransport.d.ts +1 -31
  201. package/dist/mail/types.d.ts +28 -150
  202. package/dist/{mail-DfEfSQEr.js → mail-76DWy9lj.js} +31 -289
  203. package/dist/mcp/McpServiceProvider.d.ts +4 -10
  204. package/dist/mcp/create-mcp-server.d.ts +25 -57
  205. package/dist/mcp/endpoint.d.ts +12 -36
  206. package/dist/mcp/index.js +1 -1
  207. package/dist/mvc/Controller.d.ts +46 -253
  208. package/dist/mvc/Router.d.ts +50 -129
  209. package/dist/mvc/inertia/InertiaEngine.d.ts +18 -48
  210. package/dist/mvc/inertia/shared.d.ts +6 -19
  211. package/dist/mvc/mount-route.d.ts +2 -6
  212. package/dist/mvc/view.d.ts +1 -2
  213. package/dist/notifications/Notification.d.ts +8 -75
  214. package/dist/notifications/NotificationManager.d.ts +15 -88
  215. package/dist/notifications/channels/DatabaseChannel.d.ts +1 -41
  216. package/dist/notifications/channels/MailChannel.d.ts +2 -31
  217. package/dist/notifications/channels/MemoryChannel.d.ts +2 -62
  218. package/dist/notifications/channels/SlackChannel.d.ts +3 -48
  219. package/dist/notifications/index.js +1 -1
  220. package/dist/notifications/notifiable-type.d.ts +3 -6
  221. package/dist/notifications/registry.d.ts +8 -27
  222. package/dist/notifications/types.d.ts +16 -53
  223. package/dist/{notifications-BGqmUNZ8.js → notifications-okWFs9ly.js} +37 -335
  224. package/dist/providers/AuthServiceProvider.d.ts +1 -3
  225. package/dist/providers/AuthorizationServiceProvider.d.ts +2 -3
  226. package/dist/providers/BroadcastServiceProvider.d.ts +1 -3
  227. package/dist/providers/CacheServiceProvider.d.ts +1 -3
  228. package/dist/providers/EncryptionServiceProvider.d.ts +1 -3
  229. package/dist/providers/ErrorServiceProvider.d.ts +1 -4
  230. package/dist/providers/EventServiceProvider.d.ts +1 -3
  231. package/dist/providers/HealthServiceProvider.d.ts +1 -3
  232. package/dist/providers/I18nServiceProvider.d.ts +6 -10
  233. package/dist/providers/InertiaServiceProvider.d.ts +1 -4
  234. package/dist/providers/LogServiceProvider.d.ts +1 -3
  235. package/dist/providers/MailServiceProvider.d.ts +1 -3
  236. package/dist/providers/NotificationServiceProvider.d.ts +1 -3
  237. package/dist/providers/OAuthServiceProvider.d.ts +1 -3
  238. package/dist/providers/QueueServiceProvider.d.ts +1 -3
  239. package/dist/providers/SchedulingServiceProvider.d.ts +1 -3
  240. package/dist/providers/StorageServiceProvider.d.ts +1 -3
  241. package/dist/queue/FailedJobReporter.d.ts +1 -24
  242. package/dist/queue/Job.d.ts +12 -99
  243. package/dist/queue/QueueManager.d.ts +6 -57
  244. package/dist/queue/Worker.d.ts +4 -65
  245. package/dist/queue/drivers/MemoryDriver.d.ts +3 -44
  246. package/dist/queue/drivers/RedisDriver.d.ts +7 -65
  247. package/dist/queue/drivers/SqsDriver.d.ts +6 -57
  248. package/dist/queue/drivers/SyncDriver.d.ts +10 -13
  249. package/dist/queue/index.js +2 -2
  250. package/dist/queue/types.d.ts +10 -92
  251. package/dist/{queue-CXrRK85G.js → queue-CcXCjuJI.js} +32 -260
  252. package/dist/redis/RedisApiTokenStore.d.ts +4 -56
  253. package/dist/redis/RedisEmailVerificationStore.d.ts +4 -37
  254. package/dist/redis/RedisOAuthStateStore.d.ts +2 -10
  255. package/dist/redis/RedisPasswordResetStore.d.ts +4 -37
  256. package/dist/redis/RedisRateLimitStore.d.ts +16 -49
  257. package/dist/redis/RedisSessionStore.d.ts +3 -44
  258. package/dist/redis/client.d.ts +2 -32
  259. package/dist/redis/index.js +47 -232
  260. package/dist/redis/redis-values.d.ts +6 -12
  261. package/dist/redis/scan-keys.d.ts +1 -4
  262. package/dist/request-CLOYytGP.js +68 -0
  263. package/dist/runtime/index.d.ts +2 -0
  264. package/dist/runtime/index.js +108 -74
  265. package/dist/scheduling/CronParser.d.ts +0 -29
  266. package/dist/scheduling/Schedule.d.ts +1 -153
  267. package/dist/scheduling/ScheduledTask.d.ts +0 -31
  268. package/dist/scheduling/Scheduler.d.ts +0 -70
  269. package/dist/scheduling/index.js +1 -1
  270. package/dist/scheduling/types.d.ts +4 -65
  271. package/dist/{scheduling-CPiEdtQd.js → scheduling-C6tcOtUl.js} +2 -287
  272. package/dist/storage/StorageManager.d.ts +0 -48
  273. package/dist/storage/drivers/LocalDriver.d.ts +1 -25
  274. package/dist/storage/drivers/MemoryDriver.d.ts +5 -35
  275. package/dist/storage/drivers/S3Driver.d.ts +6 -36
  276. package/dist/storage/drivers/s3-acl.d.ts +5 -10
  277. package/dist/storage/index.js +1 -1
  278. package/dist/storage/types.d.ts +27 -265
  279. package/dist/{storage-TLD9t0Q2.js → storage-BB59f07j.js} +17 -157
  280. package/dist/support/contained-path.d.ts +10 -20
  281. package/dist/support/error-polyfill.d.ts +4 -6
  282. package/dist/support/expiry.d.ts +17 -33
  283. package/dist/support/expiry.js +17 -33
  284. package/dist/support/import-map.d.ts +3 -7
  285. package/dist/support/inertia-defaults.d.ts +5 -10
  286. package/dist/support/redirect-target.d.ts +4 -6
  287. package/dist/support/stack-frames.d.ts +11 -50
  288. package/dist/support/trim-slashes.d.ts +4 -7
  289. package/dist/support/warn-once.d.ts +2 -6
  290. package/dist/{trim-slashes-ZJ_VsY5s.js → trim-slashes-BLY9hKAa.js} +4 -7
  291. package/dist/{vite-manifest-BGfWbPYp.js → vite-manifest-CTQp-SOo.js} +34 -58
  292. package/package.json +6 -2
  293. package/dist/client-Dd7vLcqp.js +0 -27
  294. package/dist/context-DoD0c7J_.js +0 -26
  295. package/dist/endpoint-D-20PiHY.js +0 -46
  296. package/dist/hot-disposables-WsTX2ySN.js +0 -281
  297. package/dist/request-CRVuIiQr.js +0 -78
@@ -1,26 +1,6 @@
1
1
  import type { LogConfig, LogChannelFactory } from './types.js';
2
2
  import { Logger } from './Logger.js';
3
- /**
4
- * Log manager for managing multiple logging channels.
5
- *
6
- * @example
7
- * ```ts
8
- * const log = new LogManager({
9
- * default: 'stack',
10
- * channels: {
11
- * console: { driver: 'console', level: 'debug' },
12
- * file: { driver: 'daily', path: './storage/logs/app.log', days: 14 },
13
- * stack: { driver: 'stack', channels: ['console', 'file'] },
14
- * }
15
- * })
16
- *
17
- * log.info('User logged in', { userId: user.id })
18
- * log.error('Payment failed', { orderId, error: error.message })
19
- *
20
- * const requestLog = log.withContext({ requestId: ctx.requestId })
21
- * requestLog.info('Processing request')
22
- * ```
23
- */
3
+ /** Log manager for managing multiple logging channels. */
24
4
  export declare class LogManager {
25
5
  private readonly config;
26
6
  private readonly channelFactories;
@@ -30,22 +10,10 @@ export declare class LogManager {
30
10
  constructor(config: LogConfig);
31
11
  private registerDefaultDrivers;
32
12
  private createStackChannel;
33
- /**
34
- * Register a custom channel driver.
35
- */
36
13
  registerDriver(name: string, factory: LogChannelFactory): void;
37
- /**
38
- * Get a logger for a specific channel.
39
- */
40
14
  channel(name?: string): Logger;
41
- /**
42
- * Get a logger that writes to multiple channels.
43
- */
44
15
  stack(channelNames: string[]): Logger;
45
16
  private resolveChannel;
46
- /**
47
- * Create a logger with additional context using the default channel.
48
- */
49
17
  withContext(context: Record<string, unknown>): Logger;
50
18
  emergency(message: string, context?: Record<string, unknown>): void;
51
19
  alert(message: string, context?: Record<string, unknown>): void;
@@ -56,28 +24,10 @@ export declare class LogManager {
56
24
  notice(message: string, context?: Record<string, unknown>): void;
57
25
  info(message: string, context?: Record<string, unknown>): void;
58
26
  debug(message: string, context?: Record<string, unknown>): void;
59
- /**
60
- * Close all channel instances.
61
- */
62
27
  close(): Promise<void>;
63
- /**
64
- * Get the default channel name.
65
- */
66
28
  getDefaultChannel(): string;
67
- /**
68
- * Get available channel names.
69
- */
70
29
  getChannelNames(): string[];
71
30
  }
72
- /**
73
- * Create a log manager instance.
74
- */
75
31
  export declare function createLogManager(config: LogConfig): LogManager;
76
- /**
77
- * Set the global log manager instance.
78
- */
79
32
  export declare function setLogManager(manager: LogManager): void;
80
- /**
81
- * Get the global log manager instance.
82
- */
83
33
  export declare function getLogManager(): LogManager;
@@ -1,76 +1,37 @@
1
1
  import type { LogChannel, LogLevel, LogContext } from './types.js';
2
2
  export interface LoggerOptions {
3
- /**
4
- * Keys whose values should be replaced with the replacement string.
5
- * Matching is case-insensitive and recursive.
6
- */
3
+ /** Keys to redact. Matching is case-insensitive and recursive. */
7
4
  filterKeys?: string[];
8
5
  /** Replacement string for filtered values. Default: '[FILTERED]' */
9
6
  replacement?: string;
10
7
  }
11
- /**
12
- * Recursively replace values of sensitive keys in a log context object.
13
- */
8
+ /** Recursively replace values of sensitive keys in a log context object. */
14
9
  export declare function filterSensitiveData(data: Record<string, unknown>, filterKeys: string[], replacement?: string): Record<string, unknown>;
15
10
  /**
16
- * Logger instance for writing log entries.
11
+ * Whether a channel's `log()` handed back something to wait on. A duck-typed
12
+ * check rather than `instanceof Promise`: a promise created in another realm
13
+ * (a `node:vm` context, a worker's module graph) satisfies the channel
14
+ * contract and would otherwise slip past the reporter as an unhandled rejection.
17
15
  */
16
+ export declare function isPromiseLike(value: unknown): value is PromiseLike<unknown>;
17
+ /** Logger instance for writing log entries. */
18
18
  export declare class Logger {
19
19
  private readonly channels;
20
20
  private readonly baseContext;
21
21
  private readonly filterKeys;
22
22
  private readonly replacement;
23
23
  constructor(channels: LogChannel[], context?: LogContext, options?: LoggerOptions);
24
- /**
25
- * Log at emergency level (system is unusable).
26
- */
27
24
  emergency(message: string, context?: LogContext): void;
28
- /**
29
- * Log at alert level (action must be taken immediately).
30
- */
31
25
  alert(message: string, context?: LogContext): void;
32
- /**
33
- * Log at critical level (critical conditions).
34
- */
35
26
  critical(message: string, context?: LogContext): void;
36
- /**
37
- * Log at error level (error conditions).
38
- */
39
27
  error(message: string, context?: LogContext): void;
40
- /**
41
- * Log at warning level (warning conditions).
42
- */
43
28
  warning(message: string, context?: LogContext): void;
44
- /**
45
- * Alias for warning().
46
- */
47
29
  warn(message: string, context?: LogContext): void;
48
- /**
49
- * Log at notice level (normal but significant conditions).
50
- */
51
30
  notice(message: string, context?: LogContext): void;
52
- /**
53
- * Log at info level (informational messages).
54
- */
55
31
  info(message: string, context?: LogContext): void;
56
- /**
57
- * Log at debug level (debug-level messages).
58
- */
59
32
  debug(message: string, context?: LogContext): void;
60
- /**
61
- * Log a message at the specified level.
62
- */
63
33
  log(level: LogLevel, message: string, context?: LogContext): void;
64
- /**
65
- * Create a new logger with additional context.
66
- */
67
34
  withContext(context: LogContext): Logger;
68
- /**
69
- * Create a child logger with additional context (alias for withContext).
70
- */
71
35
  child(context: LogContext): Logger;
72
- /**
73
- * Close all channels.
74
- */
75
36
  close(): Promise<void>;
76
37
  }
@@ -1,7 +1,5 @@
1
1
  import type { LogChannel, LogEntry, ConsoleChannelConfig } from '../types.js';
2
- /**
3
- * Console log channel.
4
- */
2
+ /** Console log channel. */
5
3
  export declare class ConsoleChannel implements LogChannel {
6
4
  private readonly config;
7
5
  private readonly minLevel;
@@ -1,7 +1,5 @@
1
1
  import type { LogChannel, LogEntry, DailyFileChannelConfig } from '../types.js';
2
- /**
3
- * Daily rotating file log channel.
4
- */
2
+ /** Daily rotating file log channel. */
5
3
  export declare class DailyFileChannel implements LogChannel {
6
4
  private readonly config;
7
5
  private readonly minLevel;
@@ -11,8 +9,6 @@ export declare class DailyFileChannel implements LogChannel {
11
9
  log(entry: LogEntry): void;
12
10
  private write;
13
11
  private rotate;
14
- private getFilePath;
15
- private getDateString;
16
12
  private ensureDirectory;
17
13
  private cleanup;
18
14
  private format;
@@ -1,7 +1,5 @@
1
1
  import type { LogChannel, LogEntry, FileChannelConfig } from '../types.js';
2
- /**
3
- * File log channel.
4
- */
2
+ /** File log channel. */
5
3
  export declare class FileChannel implements LogChannel {
6
4
  private readonly config;
7
5
  private readonly minLevel;
@@ -0,0 +1,15 @@
1
+ /**
2
+ * The `YYYY-MM-DD` stamp a file rotated at `date` carries. UTC, because the
3
+ * rotation boundary must be the same instant for every process appending to one
4
+ * directory — a fleet across time zones would write two files for one day.
5
+ */
6
+ export declare function dailyFileDateStamp(date: Date): string;
7
+ /** The dated file a base path rotates to on `date`. */
8
+ export declare function dailyFilePath(basePath: string, date: Date): string;
9
+ /**
10
+ * The date stamp of `fileName` if it is one of `basePath`'s dated files, else
11
+ * `null` — the inverse of {@link dailyFilePath}. The base name and extension
12
+ * are escaped first: `app.v1.log` would otherwise match another app's files
13
+ * into this rotation set, which for the cleanup consuming it means deleting them.
14
+ */
15
+ export declare function matchDailyFileDate(basePath: string, fileName: string): string | null;
@@ -3,6 +3,7 @@ export { LOG_LEVEL_PRIORITY } from './types.js';
3
3
  export { Logger, filterSensitiveData } from './Logger.js';
4
4
  export type { LoggerOptions } from './Logger.js';
5
5
  export { LogManager, createLogManager, setLogManager, getLogManager, } from './LogManager.js';
6
+ export { dailyFileDateStamp, dailyFilePath, matchDailyFileDate } from './daily-file-path.js';
6
7
  export { ConsoleChannel } from './channels/ConsoleChannel.js';
7
8
  export { FileChannel } from './channels/FileChannel.js';
8
9
  export { DailyFileChannel } from './channels/DailyFileChannel.js';
@@ -1,2 +1,2 @@
1
- import { a as DailyFileChannel, c as Logger, i as setLogManager, l as filterSensitiveData, n as createLogManager, o as FileChannel, r as getLogManager, s as ConsoleChannel, t as LogManager, u as LOG_LEVEL_PRIORITY } from "../logging-CPaRMuPP.js";
2
- export { ConsoleChannel, DailyFileChannel, FileChannel, LOG_LEVEL_PRIORITY, LogManager, Logger, createLogManager, filterSensitiveData, getLogManager, setLogManager };
1
+ import { a as DailyFileChannel, c as matchDailyFileDate, d as Logger, f as filterSensitiveData, i as setLogManager, l as FileChannel, n as createLogManager, o as dailyFileDateStamp, p as LOG_LEVEL_PRIORITY, r as getLogManager, s as dailyFilePath, t as LogManager, u as ConsoleChannel } from "../logging-zOY1XCtq.js";
2
+ export { ConsoleChannel, DailyFileChannel, FileChannel, LOG_LEVEL_PRIORITY, LogManager, Logger, createLogManager, dailyFileDateStamp, dailyFilePath, filterSensitiveData, getLogManager, matchDailyFileDate, setLogManager };
@@ -1,85 +1,55 @@
1
- /**
2
- * Log level types (RFC 5424 severity levels).
3
- */
1
+ /** Log level types (RFC 5424 severity levels). */
4
2
  export type LogLevel = 'emergency' | 'alert' | 'critical' | 'error' | 'warning' | 'notice' | 'info' | 'debug';
5
- /**
6
- * Log level priority (lower = more severe).
7
- */
3
+ /** Log level priority (lower = more severe). */
8
4
  export declare const LOG_LEVEL_PRIORITY: Record<LogLevel, number>;
9
- /**
10
- * Log context (additional data attached to log entries).
11
- */
5
+ /** Log context (additional data attached to log entries). */
12
6
  export type LogContext = Record<string, unknown>;
13
- /**
14
- * Log entry structure.
15
- */
7
+ /** Log entry structure. */
16
8
  export interface LogEntry {
17
9
  level: LogLevel;
18
10
  message: string;
19
11
  context: LogContext;
20
12
  timestamp: Date;
21
13
  }
22
- /**
23
- * Log channel interface.
24
- */
14
+ /** Log channel interface. */
25
15
  export interface LogChannel {
26
- /**
27
- * Write a log entry.
28
- */
29
16
  log(entry: LogEntry): void | Promise<void>;
30
- /**
31
- * Close the channel (cleanup resources).
32
- */
33
17
  close?(): void | Promise<void>;
34
18
  }
35
- /**
36
- * Log channel factory.
37
- */
19
+ /** Log channel factory. */
38
20
  export type LogChannelFactory = (config: LogChannelConfig) => LogChannel;
39
- /**
40
- * Base channel configuration.
41
- */
21
+ /** Base channel configuration. */
42
22
  export interface LogChannelConfig {
43
23
  driver: string;
44
24
  level?: LogLevel;
45
25
  [key: string]: unknown;
46
26
  }
47
- /**
48
- * Console channel configuration.
49
- */
27
+ /** Console channel configuration. */
50
28
  export interface ConsoleChannelConfig extends LogChannelConfig {
51
29
  driver: 'console';
52
30
  colors?: boolean;
53
31
  timestamps?: boolean;
54
32
  format?: 'text' | 'json';
55
33
  }
56
- /**
57
- * File channel configuration.
58
- */
34
+ /** File channel configuration. */
59
35
  export interface FileChannelConfig extends LogChannelConfig {
60
36
  driver: 'file';
61
37
  path: string;
62
38
  format?: 'text' | 'json';
63
39
  }
64
- /**
65
- * Daily file channel configuration.
66
- */
40
+ /** Daily file channel configuration. */
67
41
  export interface DailyFileChannelConfig extends LogChannelConfig {
68
42
  driver: 'daily';
69
43
  path: string;
70
44
  days?: number;
71
45
  format?: 'text' | 'json';
72
46
  }
73
- /**
74
- * Stack channel configuration.
75
- */
47
+ /** Stack channel configuration. */
76
48
  export interface StackChannelConfig extends LogChannelConfig {
77
49
  driver: 'stack';
78
50
  channels: string[];
79
51
  }
80
- /**
81
- * Log manager configuration.
82
- */
52
+ /** Log manager configuration. */
83
53
  export interface LogConfig {
84
54
  default: string;
85
55
  channels: Record<string, LogChannelConfig>;
@@ -88,9 +58,7 @@ export interface LogConfig {
88
58
  /** Replacement string for filtered values. Default: '[FILTERED]' */
89
59
  filterReplacement?: string;
90
60
  }
91
- /**
92
- * Log formatter.
93
- */
61
+ /** Log formatter. */
94
62
  export interface LogFormatter {
95
63
  format(entry: LogEntry): string;
96
64
  }